Programmer 7500/MAX_PROGRAMMERS.iso/PASCAL/SCREDIT2.ZIP/TUTOR.DOC

Text File | 1989-02-12 | 100.0 KB | 2,875 lines

                             Page  1

                   **  Turbo ScrEdit Tutor  **
                Copyright(C) 1989, by iHn Systems


This tutor is designed to step you through every aspect of  using
Turbo ScrEdit. As you read through this tutor it is assumed  that
you have successfully installed Turbo ScrEdit as described in the
file  "PRINTME.1ST",  and you are sitting at a PC  keyboard  with
Turbo ScrEdit running.

Turbo ScrEdit is an extensive program, with a lot of features and
capabilities. You should expect to spend from 3 to 4 hours  going
through this tutor.

Throughout  this  tutor, as I describe each  of  Turbo  ScrEdit's
features, I will ask you to press a key or a sequence of keys, or
type  in  a  response,   I will type  your  instructions  in  all
UPPERCASE  characters on a line by themselves.  Be sure  to  read
the complete text that proceeds each of these examples before you
try to do the example.

Example:

    Pressing the enter key at this point will cause your computer
    to stand up abruptly and tap dance across your desk:

    PRESS ENTER

In the above example you would press the enter key when you see
"PRESS ENTER".

Another Example:

    TYPE "some word or name" AND PRESS ENTER.

In the above example I want you to type the phrase surrounded  by
quotes and press the enter key. You are only expected to type the
phrase between the quotes, not the quotes.

This tutorial will be divided into two parts:

PART ONE  will step you through using Turbo ScrEdit. You will  be
     guided  through every aspect of using ScrEdit to create  and
     edit screens and screen files.

PART TWO   will  use the demonstration  files  "SCRDEMO.SCR"  and
     "SCRDEMO.P" that have been supplied with ScrEdit to show you
     one  way to implement a screen file into a  pascal  program.
     (Turbo  C  users  will  be  using  "SCRDEMO.C"  instead   of
     ScrDemo.P);

PART ONE:

To  start  with you should be looking at the Turbo  ScrEdit  Logo
screen  (or the registration information screen if you are  using
an evaluation copy of Turbo ScrEdit. Press any key to get to  the
logo  screen.)  If  you do not know how to  proceed  beyond  this
screen  you  will want to read the file "PRINTME.1ST"  that  came






                             Page  2

with  Turbo  ScrEdit. There you will find  the  instructions  for
starting  Turbo  ScrEdit  immediately  following  the  disclaimer
section.  I  would  encourage you to take the time  to  read  the
entire contents of the "PRINTME.1ST" file before you proceed with
this tutor.

When  you  enter  the Turbo ScrEdit, environment  the  main  menu
screen  will  fill  the display. Menu  options  are  selected  by
pressing  the  keys  that  correspond  to  the  highlighted   key
descriptions.  Turbo  ScrEdit's main menu  screen  contains  five
sections:
    1 - The top of the screen displays the Turbo ScrEdit  version
        number  and copyright notice.
    2 - Next  is the "Work Screen" section. This section  of  the
        screen is where we define the screen file that we will be
        creating and storing screens in.
    3 - A little lower and to the right of the screen is the
        "Key Assignments" section.
    4 - Still  lower  and back to the left of the screen  is  the
        "Copy Screen" section.
    5 - And finally the bottom line of the screen is the  message
        and  prompt  line.  If Turbo ScrEdit needs  to  tell  you
        something  or if it wants you to make a decision it  will
        display messages on this line.

Now  turn your attention to the "Key Assignments" section of  the
screen. We are going to discuss each of the keys listed here  and
their  functions.   We can see here that Turbo ScrEdit  uses  the
function  keys F1 through F10 and the "G" key to  invoke  various
functions.  Notice also on the bottom of the screen that the  ESC
key  ends  Turbo  ScrEdit, and holding down  the  shift  key  and
pressing any of the above mentioned keys will invoke the  on-line
help system and display the manual text describing the particular
key that you have pressed.

First  lets  discuss  the control keys that  do  not  pertain  to
editing screen files.

F7 - Use this key to print or view the manual.

     PRESS F7

     When  you press F7 the main menu screen will  disappear  and
     the system help screen will be displayed.

     What  you are looking at is the help system index.  You  can
     scroll  the  index up and down through the text  window  one
     line  at  a  time by using the up and  down  arrows  on  the
     keypad, or you can scroll a page at a time by using the PgUp
     and PgDn keys. Try scrolling the index text:

     PRESS DOWN ARROW (a few times)

     PRESS PgDn

     PRESS UP ARROW (a few times)

     PRESS PgUp






                             Page  3


     Lets look at Topic# 1 of the manual. This topic will discuss
     using the on-help system:

     PRESS "G"

     A  line  at the top of the screen has changed from  a  empty
     inverse line to a data entry field with a blinking cursor in
     it.  The  label to the left of the field reads  "Index  line
     Number =". Turbo ScrEdit is waiting for you to enter one  of
     the highlighted index numbers (1-21).

     TYPE "1" and PRESS ENTER

     The  index has disappeared and the text for Topic# 1 now  is
     displayed in the text window.

     Take  time now to read the manual comments about  using  the
     on-line  help system. Use the same keys (Up &  Down  arrows,
     PgUP,  PgDn) to  scroll text through the text window as  you
     did  to scroll the index. Go ahead and read the manual  text
     until you reach the section heading "THE MAIN MENU SCREEN".


   - Using the string search feature -

     Okay, now that you have read the instructions for using  the
     on-line  help  system lets explore some of the  options  you
     just  read about. First lets try the string  search  feature
     (C,S,A, and B keys).

     PRESS "C"

     In the field above the text you are being prompted to  enter
     a  string  of characters to search by.  You  can  capitalize
     words if you like, but when Turbo ScrEdit search's for  text
     it  pays  no attention to character case. Thus  "INDEX"  and
     "index" will be considered the same.

     TYPE "index" and PRESS ENTER

     Now that you have established the target of the search,  you
     must  tell Turbo ScrEdit to begin searching. You have  three
     option  for searching (S,A,B). The "S" option  means  search
     the  entire  manual for the first occurrence of  the  target
     string.

     PRESS "S".

     There will be a brief pause while the search is in progress.
     When  a  match is found the line that  contains  the  search
     target  will  be  displayed on the first line  of  the  text
     window.

     The  "A" search option means search ahead in the  text  from
     the current position in the manual.

     PRESS "A"






                             Page  4


     To  search  backward  throught the  text  for  the  previous
     occurrence.

     PRESS "B"

     In the case that the target string is not found in the  text
     Turbo ScrEdit will display a message and end the search.


   - Printing All or Part of the Manual -

     If  you do not have a printer attached to your system,  skip
     to the next section.  If you have a printer attached to your
     system lets look at how to print all or part of the manual.
     PRESS F1

     In  the field above the text you are being prompted for  one
     of four  possible responses.
     1. If you press the ESC key the print process is aborted.
     2. If you type "E" and press enter the entire manual will be
        printed.
     3. If you type "I" and press enter the manual index will  be
        printed.
     4. If  you type a topic number (listed on the  manual  index
        listing  described  above), and press enter,  that  topic
        will be printed.

     Lets  try  the "I" option described above for  printing  the
     index:

     TYPE "I" and PRESS ENTER

     Now  that you have a listing of the manual index,  lets  try
     looking  up  a topic. The topic look up function  will  work
     differently  depending on where you are in the on-line  help
     system. There are two possibilities:
     1st - When you are browsing through the manual text and want
           to  skip  to  another  part  of  the  manual   without
           scrolling to it.

           PRESS "G"

           Select  a  topic from the manual index  that  we  just
           printed.  If you couldn't print an index listing  just
           use Topic# 10.

           TYPE  "10"  (or any topic# of your choice)  and  PRESS
           ENTER

           The  text for the selected topic# should now fill  the
           screen.  Try  looking up any of the topics  (1-91)  on
           your own before you continue.

           When  you are ready to continue we will use  the  home
           key to return to the main index. Remember whenever you
           are reading the manual you can return to the index  by
           pressing the home key.






                             Page  5


           PRESS HOME

     2nd - When  you are browsing through the help  system  index
           and want to go to the text of one of the index topics:

           PRESS "G"

           Select one of the 21 highlighted topic numbers to  the
           left  of  the index text. For this example  let's  use
           number 10 again:

           TYPE "10" and PRESS ENTER

           The text for Topic# 10 should now fill the screen.

     Well  that  ends the discussion on using  the  on-line  help
     system.  Remember you can enter into the on-line help system
     from  just about any place while using Turbo ScrEdit. As  we
     go  though the other features of Turbo ScrEdit I  will  show
     you how to get context sensitive help for whatever keystroke
     that  you  need  help with. Lets return  to  the  main  menu
     screen:

     PRESS ESC


- Exiting the Turbo ScrEdit environment -

Using the ESCape key:

     The  ESC key is used throughout Turbo ScrEdit to  "quit"  or
     "exit".  If  you are performing a function you  can  usually
     abort  that function by pressing ESC. Other  times  pressing
     the ESC key will cause you to return to the main menu.

     When you are in the main menu of Turbo ScrEdit, pressing the
     ESC key will end your current session with Turbo ScrEdit and
     return you to the DOS prompt.


- Viewing disk directories -

There  will  be  times when you will want to look  for  files  in
different  directories on your disks without having to  exit  the
Turbo ScrEdit environment. You will use the main menu F9 function
for this purpose.

     PRESS F9.

     The  screen  has  cleared and the words "Dir  Mask  ?"  have
     appeared in the top left corner of the screen.

     PRESS ENTER.

     The disk directory is displayed for the current, or default,
     drive.  Notice  that "*.*" is the  default  file  designator
     mask.   Notice  also  that  directories  are  displayed   in






                             Page  6

     different color attributes.

     You may answer the "Dir Mask ?" prompt with any valid MS-DOS
     file identifier including wild card characters. You can read
     more on displaying directories by pressing SHIFT and F9 keys
     from the main menu screen.

     PRESS SPACE BAR - to return to the main menu screen.

     PRESS SHIFT and F9 at the same time.

     The  main menu screen has just been replaced by the  on-line
     help  system and the text describing the F9 menu  option  is
     displayed.

     PRESS ESC - to return to the main menu.


Now  lets look at the control keys that pertain to  working  with
screen  files.  Just so we know that we are  standing  on  common
ground at this point let me define a screen file:

    A screen file will contain a collection of screen records.  A
    screen  file  will  appear in your  disk  directory  with  an
    extension of ".SCR". Each screen that you design for use in a
    program will become 1 of the possible 128 screens that can be
    stored in a screen file.

So  it is logical that we must first create a screen file  before
we can begin storing screen records in it. The F1 key is used for
specifying the name of the screen file to be created or edited.


- Selecting a work screen file -

F1 - specifying the screen file to create or edit.

    Locate  the section of the screen labeled "Work  Screen"  and
    the  word "Undefined" in the highlighted line that spans  the
    screen.

    PRESS F1

    Notice  that the word "Undefined"  and the  highlighted  line
    have  been  replaced  by  a blank data  entry  field  with  a
    blinking  cursor in it.  Turbo ScrEdit is waiting for you  to
    type in the name of a screen file to be created or edited.

    TYPE "TestxxScr" (DO NOT press the enter key yet)

    - Field editing features -

    Before we press the enter key and create this file, lets look
    at  some of the editing features that Turbo ScrEdit  provides
    when  keying  data into a field on the screen.
        -  The  blinking cursor that is now sitting to the  right
           of the word "TestScr" is actually a "floating cursor".
           This  means that it can be moved either  direction  in






                             Page  7

           the field using the left and right arrow keys.

           PRESS LEFT ARROW (6 times)
           PRESS RIGHT ARROW (3 times)

           The cursor should now be blinking on the second 's' in
           the word "TestxxScr". The BACKSPACE key will move  the
           cursor  to the left on the screen line and delete  the
           charcter to the left of the cursor each time it moves.

           PRESS BACKSPACE (2 times)

           The  "xx"  was  deleted  leaving  you  with  the  word
           "TestScr".  If  you  make  a  typing  error,  you  can
           use  these  keys  to  position  the  cursor  over  the
           incorrect   characters   and   re-type   the   correct
           characters.  When the ENTER key is pressed, the entire
           field  is  read No matter where the cursor is  in  the
           field

        -  Notice  on  the bottom line of the  screen  the  words
           INSERT, CAPS, SCROLL LOCK, NUM LOCK.

           TRY  PRESSING THE INSERT, SCROLL LOCK, CAPS,  AND  NUM
           LOCK KEYS ON YOU KEYBOARD

           Each  time you press one of the keys,  the  respective
           label toggles between highlighted and normal text.

           When  the  CAPS label is highlighted,  typing  at  the
           keyboard will produce characters in uppercase.

           When  the NUM LOCK  label is highlighted, the  numeric
           key  pad  can  be used to  enter  numbers  instead  of
           cursor control characters.

           When  SCROLL LOCK is highlighted it has no  effect  in
           Turbo ScrEdit.

           When the INSERT label is highlighted, any key that you
           type  will  be inserted into the line at  the  cursor.
           When the INSERT label is displayed in normal text  any
           keys that you type will overtype whatever character is
           at  the  cursor. Use the rigth arrow key to  move  the
           cursor to the "t" in the middle of "TestScr".

           WITH INSERT MODE ON (highlighted) TYPE SOME CHARACTERS
           INTO THE LINE.

           USE THE ARROW KEYS TO MOVE THE BLINKING CURSOR BACK TO
           THE FIRST CHARACTER THAT YOU JUST TYPED INTO THE LINE.

        -  The  DELete  key will delete the  character  that  the
           blinking cursor is on.

           USE  THE DELETE KEY TO DELETE THE CHARACTERS YOU  JUST
           TYPED.







                             Page  8

     The field editing features that we just discussed will  work
     the  same  in just about any field on any  screen  of  Turbo
     ScrEdit. Any programs that you write that use Turbo  ScrEdit
     screens will also have the same editing features.

     Now lets resume our discussion on specifying the screen file
     that  is to be created or edited. Make sure that  you  still
     have the screen file name "TestScr" typed on the data  entry
     line.

     PRESS ENTER

     The bottom line of the screen now displays the message:
        "<TESTSCR.SCR> does not exist. Create it? N/Y"

     PRESS "Y".

     Any  key  pressed other than "Y" is considered as  "N".  But
     since  we answered with yes the screen file is created.  The
     line where we entered the screen file name has returned to a
     inverse field with the screen file name displayed in it.

     Screen  file names must be valid MS-DOS file names. You  can
     include the drive, path, filename, and extension in the file
     name.  If  drive  or path is omitted  the  the  current  DOS
     default  path is used. If you supply the extension  part  of
     the  file name, it must be ".SCR". Turbo ScrEdit  will  only
     edit (.SCR) files.


- Working with screen files -

We  now  have a screen file open and ready for use.  Notice  that
there  are some highlighted key labels inside the  "Work  Screen"
section  with  the  words "Next", "Prev",  "Add",  "Delete",  and
"Rename" next to them.

    - Adding screens to a screen file -

    The  first thing we want to do is add a screen record to  the
    file.  Notice that the INS key label has the word "Add"  next
    to it. Use the insert key to add a screen to the screen file:

    PRESS INSERT

    When  you  pressed the INSERT key the top line of  the  small
    window  inside the "Work Screen" section turned into  a  data
    entry  field with a blinking cursor in it. Turbo  ScrEdit  is
    prompting you for a screen name. Screen names must start with
    an  alphabetical  character  and can contain  only  alpha  or
    numeric  characters  or the underline character. If  you  are
    going to write a program to use a screen then the screen name
    that you specify here will be used as the record name  inside
    your program, so be sure that the name conforms to the record
    naming standards of your compiler.

    TYPE "Test" and PRESS ENTER.







                             Page  9

    We have just created our first screen. You can use the insert
    key  in  this fashion to add up to 128 screens  to  a  screen
    file.  Notice that the line that the screen name is on  is  a
    highlighted  line. Whenever a screen name is being  displayed
    on this line, it will be the active screen or the screen that
    is going to be edited, compiled, etc.

    - Renaming a screen -

    Locate  the  highlighted label for the TAB key that  has  the
    word  "Rename"  next to it.  Lets rename the screen  that  we
    just added from "Test" to "Test_One".

    PRESS TAB.

    The  screen  name line has gone blank, at the bottom  of  the
    screen the message "Rename <Test> to ?" has appeared.

    TYPE "Test_One" and PRESS ENTER.

    Now  that you know how to add and rename screens, try one  on
    your  own.  Lets  see if you can  add  another  screen  named
    "Test_Two"  by  yourself. When you  are  finished  "Test_One"
    should  not be visible on the screen, but don't worry  it  is
    still there.

    - Scrolling through screens in a file -

    Locate  the  "HOME" and "END" key labels next  to  the  words
    "Next" and "Prev". When you have more than one screen  stored
    in  a screen file you will use these keys for  scrolling  the
    screen  names. Experiment with the HOME and END keys  to  see
    how  the  screen  names can be scrolled in  and  out  of  the
    highlighted line.

    - Deleting a screen from the screen file -

    We have one more control key to try before we begin editing a
    screen.  Scroll  "Test_Two"  to the top line  of  the  screen
    window:

    PRESS DEL.

    The bottom line of the screen changes to read:

    "<Test_Two> Press <Del> Again to delete or <ESC> to abort"

    Turbo ScrEdit is giving you a chance to back out of  deleting
    the screen by pressing the ESC key.

    PRESS DEL.

    The  screen is deleted. COMPLETELY!! so be careful with  this
    one. If you accidentally delete a screen you can retrieve  it
    from  the backup file that Turbo ScrEdit makes each time  you
    begin to edit a file. I will show you more on this later.

    Lets re-add "Test_Two".






                             Page  10


    And add another screen "Test_Three".

- Automatic backup files -

There  are  two  more things I  want  to  demonstrate  concerning
working  with screen files. As I mentioned above,  Turbo  ScrEdit
will  automatically  create  backups of your work  for  you.   To
demonstrate this:

PRESS F1.

Notice  that the edit file line went blank and the  screen  names
have disappeared from the "Work Screen" section. Turbo ScrEdit is
finished with the file that we were working on and is asking  for
a new screen file name. Lets just call back "TESTSCR.SCR" again.
As  you  perform  the next instruction, be  sure  to  notice  the
message  that will appear on the bottom line of the  screen  when
you press the enter key.

TYPE "TestScr" and PRESS ENTER.

If  you  were  quick enough you saw the message  stating  that  a
backup  file  of  "TestScr" was  being  created.   Turbo  ScrEdit
checked  and  did not find a backup copy of the screen  file.   A
backup copy of a screen file will always have the same file  name
with  a  extension of ".SBK".  Turbo ScrEdit  will  automatically
create  a backup of your screen files whenever a file  is  opened
and no backup file exists in the same directory.  Next lets  look
at  what will happen when the screen backup file is present  when
the work screen is loaded.

PRESS F1.

Again the edit file name has gone blank and the screen names have
disappeared from the screen.

TYPE "TestScr" and PRESS ENTER.

This time a backup file was found. The bottom line of the  screen
now  displays  a prompt asking you to decide whether or  not  you
want to overlay the current backup file with the current copy  of
the  screen  file.  If you respond by pressing the  "N"  key  the
backup file will not be updated.

PRESS "Y".

Well that pretty well covers the fundamentals of creating  screen
files, and adding screen records into the screen file. By now, if
I  have  been clear in my descriptions, you should  have  a  good
understanding of how to:
    1.  Exit ScrEdit and return to DOS.
    2.  Use the help system.
    3.  Look at disk directories.
    4.  Create a screen file.
    5.  Add screens to the file.
    6.  Delete screens from the file.
    7.  Rename screens in the file.






                             Page  11

    8.  Scroll through the screens in a screen file.
    9.  Select an existing screen file to edit.
   10.  Make and locate Turbo ScrEdit backups of your files.

From  this point forward I am going to assume that you  know  and
understand the above list of ten items. If you are unsure of  how
to use any of the features go back now and review them until  you
are comfortable with them.


- Editing a screen record -

Next  we  will  look  at the screen  editing  features  of  Turbo
ScrEdit.

F2 - Editing a screen.

    Scroll  the  screen named "Test_Three" into  the  highlighted
    line  of the screen names window. Selecting the F2 option  of
    the main menu will invoke the screen editing facility.

    PRESS F2.

    - The editor status line -

    The  menu  has  disappeared and you are looking  at  a  blank
    screen. The bottom line of the screen looks like:

    1  1 Ins <Off> Graph <Off> Back <  0> [**] For <  2> Esc=Exit F1Key=Help

    This is the screen editor status line. From left to right  it
    tells  you:  the current row and column that  the  cursor  is
    positioned  on; if the keyboard insert mode is ON or OFF;  if
    the  keyboard  graphics  character mode is  ON  or  OFF;  the
    current background and foreground color codes. It also  tells
    you that pressing ESC will return you back to the main  menu,
    and pressing the F1key will display a help screen. The F1 key
    option  here is a more local help screen, but  remember  that
    you  can get detailed help on any function of the  editor  by
    holding  down  the SHIFT key and pressing any of  the  screen
    editor control keys that we are about to discuss.

    - Cursor movement keys -

    As  you perform the next examples be sure to notice that  the
    row and column indicator on the far right of the status  line
    changes as the cursor moves.

    PRESS DOWN ARROW (a few times).
    PRESS UP ARROW (a few times).
    PRESS LEFT ARROW (a few times).
    PRESS RIGHT ARROW (a few times).

    The  arrow  keys move the cursor one screen position  in  the
    respective directions each time a key is pressed.

    PRESS TAB (a few times).
    PRESS SHIFT TAB (a few times).






                             Page  12


    This time the cursor moves in 5 character increments.

    PRESS BACKSPACE

    The  backspace  key has the same effect that the  left  arrow
    key did.

    PRESS ENTER

    The  enter key always causes the cursor to move to the  first
    character of the next line.


    - Insert and overtype modes -

    Next  to the row and column indicators of the status line  is
    the insert mode indicator. Observe how this indicator changes
    as you perform the next example.

    PRESS INSERT (a few times(key pad 0)).

    Notice  that the Insert mode indicator toggles between  <Off>
    and  <On  >. When insert mode is ON the characters  that  you
    type  will be inserted into the current line of text and  the
    characters to the extreme right of the line will disappear as
    they  scroll  off  the  line. When Insert  mode  is  OFF  the
    characters typed will overwrite any characters on the line.

    - Keyboard graphics mode -

    PRESS F2 (a few times)

    Notice  that  the Graph indicator toggles between  <Off>  and
    <On> each time you press F2 key.

    When  GRAPH  mode  is ON, the  keyboard  will  type  graphics
    characters  instead of numbers and  alphabetical  characters.
    When GRAPH mode is OFF, normal keyboard characters are typed.

    - Quick reference editor help screen -

    PRESS F1

    The local screen editor help screen is displayed. This screen
    is  used  as  a quick reference  for  accessing  the  editors
    special functions.

    The help screen is divided into three sections:
        1.  Fkey assignments.
        2.  Keyboard graphics and line drawing assignments.
        3.  Other special key function to control color selection,
            and cursor movement.

    PRESS ANY KEY - to return to the screen editor.

    Lets explore using the F2 key option next.







                             Page  13

    PRESS F2 until GRAPH <OFF> shows on the status line.

    PRESS ENTER - to get to the start of the next line.

    TYPE "1234567890 abcdefghijklmnopqrstuvwxyz" and press ENTER

    PRESS F2 (GRAPH <ON >).

    TYPE "1234567890 abcdefghijklmnopqrstuvwxyz" and press ENTER

    This time we typed graphics characters instead of numbers and
    alphabetical characters.

    PRESS F1

    Examine the "Keyboard Graphics Character Assignments" part of
    the help screen. In the top part of this section you see  the
    various  extended  graphics characters, each with  a  regular
    keyboard  character  to it's left. In the bottom  portion  of
    this  section  you  see a group of  boxes.  These  boxes  are
    arranged  to make it easy to locate any of the  special  line
    drawing  characters you may need when drawing  screen  forms.
    Notice  that some of the characters in each of the boxes  are
    highlighted   with  regular  keyboard  characters  to   thier
    immediate  left.  Typing the highlighted  keyboard  character
    while  in  graphics  mode  will  produce  the  line   drawing
    character  to  it's  right. Notice also  that  a  upper  case
    character or shifted key will produce a different  characters
    that the lower case character or a un-shifted key.

    Press any key to return to the screen that we are editing.

    PRESS ANY KEY

    Next,  take a few minutes and draw some lines and boxes.  Use
    the  F1  help option to determine which keys  to  use.  Turbo
    ScrEdit has line and box drawing functions, but this exercise
    is  intended  to  let you get  comfortable  using  the  quick
    reference  screen,  so  draw these boxes  by  typing  in  the
    characters  that you choose for the quick  reference  screen.
    Mix  some  text in with the graphics characters  by  toggling
    graph mode ON and OFF as you type.

    Experement all that you wish before continuing.

    PRESS THE F1KEY again.

    Locate the Video Color Control keys in top part of the  lower
    right  hand area of the screen.  You see that pressing  these
    keys will change the foreground and background colors of  the
    characters  that  you type. Press any key to  return  to  the
    editor screen.

    Locate the "Back < 0> [**] For < 2>" part of the status line.
    Notice  the changes that occure here as you perform the  next
    example.

    TRY PRESSING THE  HOME, END, PGUP, and PGDN keys.






                             Page  14


    The  "[**]"  part of the status line changes to  reflect  the
    current background and foreground color attributes that  will
    be used for the next characters typed on the screen.

    Now Type some characters and graphics characters in different
    colors (or shades on a monochrome monitor.)

    Now  move the cursor up into one of the lines that  you  have
    typed  and experiment with the insert (INS) and delete  (DEL)
    keys. When you toggle Insert ON the characters that you  type
    are  inserted  into the line, with insert  OFF  you  overtype
    characters.  The  delete  key deletes the  character  at  the
    cursor.

    - Inserting blank lines into a screen -

    PRESS F3.

    This key inserts blank lines into the screen.

    - Deleting lines from the screen -

    PRESS F4.

    This key deletes lines from the screen.

    - Saving and Undoing screens -

    Turbo  ScrEdit  has an undo feature that lets you  restore  a
    screen to its original state if you happen to make a  mistake
    and delete the wrong line or characters, or type in the wrong
    thing on a screen. In order to make the undo feature work for
    you,  you  will want to store a screen  occasionally  as  you
    design it. To demonstrate this, we know that when we  started
    we  started with a blank screen, so lets store the screen  as
    it look right now.

    HOLD DOWN ALT and PRESS F5

    Turbo  Scredit prompts you on the bottom line of  the  screen
    with:

        "Okay to store N/Y"

    PRESS "Y"

    We  have just stored the screen as it now appears. The ALT  -
    F5 keys are used in conjunction with the F5 undo feature. Any
    changes  that  you make to a screen can be  un-done  back  to
    whatever  the screen looked like when you entered the  editor
    or back to what the screen looked like the last time you used
    the ALT - F5 keys to store it. To demonstrate this:

    TYPE SOME TEXT ON THE SCREEN - anything you type will do.

    PRESS F5.







                             Page  15

    The bottom of the screen displays the message:

        "Are you sure you want To Undo  screen (N,Y)"

    PRESS "Y".

    The text that you typed on the screen disappeared. It was un-
    done.

    AGAIN TYPE SOME TEXT ON THE SCREEN - anything you type  will
    do.

    HOLD DOWN ALT and PRESS F5

    PRESS Y

    PRESS F5.

    The bottom of the screen displays the message:

        "Are you sure you want To Undo  screen (N,Y)"

    PRESS "Y".

    This  time the text that you typed was not removed  from  the
    screen because ALT - F5 made the changes permanent. You don't
    have  to always use ALT and F5 to store the screen. When  you
    exit  the screen editor back to the main menu you  will  have
    the  option of storing the screen. You only need to  use  ALT
    and  F5  when you are happy with the screen in  progress  and
    don't  want to take a chance of losing it to a power  failure
    or some other accident.

    - Cutting and pasting screen text -

    Next  lets  look at the the cut and paste  functions.  It  is
    often  desirable to be able to replicate or move portions  of
    the screen as you are creating it.

    USE  THE  ARROW KEYS TO MOVE THE CURSOR TO ONE OF  THE  LINES
    THAT YOU HAVE TYPED ON.

    PRESS F6.

    F6  key  starts the process of copying blocks, or  lines,  or
    moving  blocks of text around on the screen. Notice that  the
    message line of the screen now reads:

        "** Copy <B>lock or Copy <L>ine or <M>ove block **"

    - Copying a block of text -

    For our first experiment lets use the "B" option and copy a
    block of the screen.

    PRESS "B".

    The message line of the screen has changed to:






                             Page  16


        "** Highlight a Block of Text **  F1key = Help  Escape = Exit ".

    The message tells us that pressing the Escape key will  abort
    the  block  copying procedure and return you to  the  editing
    mode,  Or  pressing the F1 key will invoke the  on-line  help
    system  and  display the manual text describing  copying  and
    moving blocks of text.

    Copy text is a four step procedure: first we must highlight a
    section  of the screen that we want to copy; second we  press
    the enter key to grab the highlighted section of the  screen;
    third we move the block of text to the postion on the  screen
    where  we want to place it; fourth we press the enter key  to
    make it permanent.

    So  lets begin with the first step. The blinking  cursor  has
    now become a highlighted character. The term highlighted here
    means  that  the  characters that are being  selected  to  be
    copied  will be shown in inverse colors. If the text  of  the
    screen  normally  has  a black background  then  it  will  be
    highlighted with white background and a black foreground.  Or
    if   the  characters  being  highlighted  have  a   non-black
    background  color,  then they will be highlighted  as  bright
    white characters on a black background.

    PRESS the RIGHT ARROW  10 to 15 times.

    The highlighted area expanded horizontally each time you
    pressed the right arrow key.

    PRESS the DOWN ARROW 5 or 6 times.

    The  highlighted area expanded vertically to cover more  text
    each time you press down arrow key.

    PRESS the LEFT ARROW  2 times.

    The highlighted block of the screen is reduced horizontally.

    PRESS the UP ARROW 2 times.

    The highlighted block of the screen is reduced vertically.

    So we see that the arrow keys are used define the size of the
    area that we will be copying. The screen text that is  inside
    the  highlighted  area  will be the text to  be  copied.  The
    highlighted block may be repositioned anywhere on the  screen
    by using the arrow keys while holding down the shift key.

    HOLD DOWN ONE OF THE SHIFT KEYS.

    PRESS UP    3 times to move the highlighted block up.
    PRESS DOWN  3 times to move the highlighted block down.
    PRESS RIGHT 3 times to move the highlighted block right.
    PRESS LEFT  3 times to move the highlighted block left.

    Remember  Step  one was to highlight the area of  the  screen






                             Page  17

    that we want to copy. Take time now to use the keys described
    above  to  highlight  a section of the  text  that  we  typed
    earlier.

    The  second  step  is to "grab" the  section  of  the  screen
    highlighted by pressing the enter key.

    PRESS ENTER.

    The  highlighted  block has disappeared and  the  screen  has
    changed back to its original appearance. On the bottom of the
    screen  there  is now a message asking you  to  position  the
    block  where  you want it on the screen and press  the  enter
    key.  Remeber this is step three.

    PRESS DOWN ARROW a few times to move the block of text down.
    PRESS UP ARROW a few times to move the block of text up.
    PRESS RIGHT ARROW a few times to move the block of text right.
    PRESS LEFT ARROW a few times to move the block of text left.

    The Text that was highlighted now moves around on the  screen
    freely  without  disturbing any of the text  that  it  passes
    over.  Move the text to another part of the screen using  the
    keys  listed above. Step four was to press enter to make  the
    text permanent on the screen.

    PRESS ENTER.

    The  block of text is now permanent in that position  of  the
    screen.   Remeber  these four steps. They will alway  be  the
    same using any of the text copy or move operations.

    - Copying a line of text -

    This time lets look at the "L" option for copying a line of
    the screen.

    PRESS F6

    PRESS "L"

    Notice this time that the entire line of the screen where the
    cursor  was setting is now inverted. Actualy the  "L"  option
    works  much like the "B" option, except it will do the  first
    step  for you and highlight the entire line of text.  If  you
    only  want  to  copy the highlighted line of  text,  you  can
    proceed  to step two (press enter), three (position the  line
    on  the  screen),  and four (press enter  to  make  the  line
    permanent.) But, if you decided that you wanted more or  less
    text  than  what is highlighted, you can use  the  same  keys
    described  in  step one of the "B"lock option to  change  the
    size  of  the block of text to copy, and  then  proceed  with
    steps two through four.











                             Page  18

    - Moving a block of text -

    PRESS F6 again

    This  time try the "M"ove option on your own. It  works  just
    like  the "B"lock option only it will actually cut the  block
    of text out of the screen and move it.  Take time now to play
    with  these  features until you are satisfied that  you  have
    mastered cutting and pasting.

    - Drawing and painting lines and boxes -

    Next  lets  look at the line and box  drawing,  and  painting
    features of Turbo ScrEdit.

    The  F7, F8, and F10 keys are used for drawing lines,  boxes,
    and  painting areas of the screen. The line and  box  process
    will always begin by using the F10 key to specify the type of
    character  that the line or box is to have as a border.  Then
    the F7 key is used to mark the left extreme end of a line  or
    corner  of  a box, and the F8 key is used to mark  the  right
    extreme  end of a line or corner of a box. When both  the  F7
    key and F8 key have been pressed Turbo ScrEdit will draw  the
    line or box between the two points.

    Lets  start  by  drawing a line. First  we  must  tell  Turbo
    ScrEdit  what type of line we want to draw. Pressing the  F10
    key begins the process.

    PRESS F10.

    The message line now displays:

    "Enter ASCII Char code 00-255 or <S>ingle <D>ouble <B>old <P>aint"

    Turbo ScrEdit is prompting for the type of character that you
    want  to use to draw the line with. You can enter  any  ASCII
    character  code  (0 thru 255), or select  the  extended  line
    drawing  characters  for  <S>ingle line,  <D>ouble  line,  or
    <B>old line.

    For this example lets draw a single line.

    PRESS "S" and PRESS ENTER.

    USING THE ARROW KEYS MOVE THE CURSOR TO ROW 5 AND COL 1.

    PRESS F7.

    The message on the bottom of the screen tells you to position
    the  cursor  on the extreme bottom right corner of  the  line
    that we are about to draw.

    **  NOTE  **  The following is a very  important  concept  to
    understand about drawing lines verses boxes. In text mode our
    screen consists of 24 rows and 80 columns. Turbo ScrEdit will
    draw  lines horizontally across the screen when both  the  F7
    and F8 keys are used to mark positions on the same row of the






                             Page  19

    screen. Likewise vertical lines are drawn on the screen  when
    the  the F7 and F8 keys mark position on the same  column  of
    the screen.

    USING  THE RIGHT ARROW KEY, MOVE THE CURSOR TO COLUMN  80  OF
    THE SAME ROW 5.

    PRESS F8.

    A line was drawn horizontally acrost the screen.

    PRESS F10 again.

    PRESS "S" again.

    USE THE ARROW KEYS TO MOVE THE CURSOR TO ROW 1 AND COLUMN 40.

    PRESS F7.

    USE  THE  DOWN  ARROW KEY TO MOVE THE CURSOR TO  ROW  24  AND
    COLUMN 40.

    PRESS F8.

    This time the line was drawn vertical on the screen.

    Use  the HOME key to change the current background color  and
    press the F7 key or F8 key again. The line that we just  drew
    will  change  according  to the current  colors.  Using  this
    feature  you can try different colors until you find the  one
    that suits your needs.

    Next lets draw some boxes on the screen.

    PRESS F10.

    PRESS "D" for Double line and PRESS ENTER.

    USE THE ARROW KEYS TO MOVE THE CURSOR TO ROW 10 COLUMN 10.

    PRESS F7.

    USE THE ARROW KEYS TO MOVE THE CURSOR TO ROW 20 COLUMN 70.

    PRESS F8.

    ScrEdit  is now asking you if it should paint the  area  with
    the current color.

    PRESS "N".

    Using the HOME or END keys select the background (Back< 1>).
    Using the PgUP or PgDn keys select the foreground (For <15>).

    PRESS F8.

    This time answer yes to the "Paint?" prompt.







                             Page  20

    PRESS "Y".

    Using  the  paint  option is very much  like  using  the  box
    option.  Next  we will use the F10 key again and  select  the
    <P>aint option. The paint option works just like box  drawing
    only  it  does  not draw a border around the  area,  it  just
    paints the current colors into the defined area. Go ahead and
    try painting the entire screen with different colors.

    Using the HOME or END keys select the background (Back< 7>).
    Using the PgUP or PgDn keys select the foreground (For <15>).

    PRESS F10.

    PRESS "P"  AND PRESS ENTER.

    USE THE ARROW KEYS TO MOVE THE CURSOR TO ROW 12 COLUMN 15.

    PRESS F7.

    USE THE ARROW KEYS TO MOVE THE CURSOR TO ROW 18 COLUMN 65.

    PRESS F8.

    Turbo  ScrEdit  has painted the current area  with  a  bright
    background and bright white foregroud.

    That  pretty  well describes using the line, box,  and  paint
    options  of  the screen editor. There are some  cautions  you
    should  keep  in  mind when using the line  and  box  drawing
    features.
    1.  NEVER  erase a box or screen by using 0 foreground and  0
        background  colors.  It  leaves  the  characters  on  the
        screen, you just don't see them. The correct way to erase
        a line or box is to re-draw it using spaces:
        a.  Press F10, type 32 and PRESS ENTER.
            (Remember 32 is the ASCII code for Space).
        b.  Using the F7 and F8 keys mark the corners for the new
            box  on the corners of the old box or line  that  you
            want to erase.

    - Typing any ASCII character code -

    We  have one key left to explore. When the extended  graphics
    characters were assigned to the keyboard for use in  graphics
    mode,  there  was  not enough keys  to  accommodate  all  the
    characters  codes.  To  give you access  to  the  full  ASCII
    character  set, Turbo ScrEdit will let you assign  any  ASCII
    code 0 thru 255 to the lower case "v" key.

    PRESS F9.

    The message line displays the prompt:
        " Enter "v" an ASCII character code (0 thru 255) "

    TYPE 17 and PRESS ENTER.

    PRESS F2 (until Graph mode is ON.)






                             Page  21


    PRESS "v"

    The "v" key now types a left pointer.

    PRESS ESC.

    The message line now prompts:
    " Save Screen (Y/N) "

    PRESS "Y".

    Our  editing  session has ended and we are back to  the  main
    menu screen. Turbo ScrEdit has stored the screen and is ready
    for  another  task. The exercise that we  just  finished  has
    given  you  a  little sample of  all  the  editing  functions
    supported by Turbo ScrEdit.

    Now  lets  use what we have learned to draw  a  more  serious
    screen  and  discuss  how to define data  entry  and  display
    fields on a screen. Here is a list of the rules for  defining
    screen fields:
    1.  A screen field starts with a left bracket "[".
    2.  A screen field can be from 1 to 78 characters in length.
    3.  A screen field cannot span lines on the screen.
    4.  A screen field name cannot exceed 16 characters and  must
        conform  with the rules that apply to naming fields in  a
        record for your particular compiler.
    5.  A screen field must end with a right bracket "]".
    6.  You can define from 0 to 128 fields on a screen.
        (a screen with no fields might be used for menus,
        help screens, etc.).

    Since  we were experimenting with "Test_Three", lets use  the
    screen  "Test_One" for our next example. Use the HOME  and/or
    END  keys to scroll "Test_One" to the top line of  the  "Work
    Screens" window.

    PRESS F2.

    As  we re-enter the screen editor, the screen has  gone  bank
    with only the editor status line showing on the bottom of the
    screen.   The  screen  that  you  are  about  to  draw   will
    demonstrate defining and using screen fields. As you draw the
    screen,  experiment by adding lines and boxes to section  off
    the  areas  of the screen. Make it look the way  you  like  a
    screen to look.

















                             Page  22

    Purchase History:
        ----------------------------------------------------
        Year     Quarter 1  Quarter 2  Quarter 3  Quarter 4
        ----     ---------- ---------- ---------- ----------
       [Yr_1]    [Qt_1a   ] [Qt_2a   ] [Qt_3a   ] [Qt_4a   ]
       [Yr_2]    [Qt_1b   ] [Qt_2b   ] [Qt_3b   ] [Qt_4b   ]
       [Yr_3]    [Qt_1c   ] [Qt_2c   ] [Qt_3c   ] [Qt_4c   ]
        ----------------------------------------------------

    Customer:
        ---------------------------------------------
        Name....[Name_Field                         ]
        Address.[Address_Line_1                     ]
                [Address_Line_2                     ]
        City....[City         ]
        State...[St]  Zip Code...........[ZipCode   ]

        Phone...[Ph1]-[Ph2]-[Ph3 ]
        ---------------------------------------------


    When you are finished:

    PRESS ESC (To exit to the main menu).

    PRESS "Y" (To save your work).

We  have a screen now, but Turbo ScrEdit does not  know  anything
about the screen accept what it's name is and where it is stored.
The next thing we want to do with our screen is compile it  using
the main menu F4 option. When a screen is compiled several things
happen:

    1 - The screen is scanned to locate any fields that have been
        defined   on it. The field name and it's row  and  column
        coordinates  are  placed  in a  table  along  with  other
        information.

    2 - Turbo ScrEdit then allows you to define what type of data
        each  field will be allowed to contain. During this  step
        you  can assign a field help message and data  validation
        ranges and procedures.

    3 - Finally  when  you are finished Turbo ScrEdit  creates  a
    file  of source code definitions for the buffers  written  in
    the  programming  language of your choice. If you  load  this
    file  into your text editor you will find the fields of  your
    screen are defined as fields in a record definition.

Ok, now that you have an idea of just what is about to happen:

PRESS F4.

    The main menu screen has disappeared and the compiler  screen
    is  displayed.  In  the bottom section of  the  screen  Turbo
    ScrEdit  is  displaying the current default values that  will
    be used by the  screen compiler.







                             Page  23

    Turbo  ScrEdit needs to know which language compiler you  are
    working  with.  In the bottom part of the screen there  is  a
    line  that  starts  with  a  highlighted  "L"  on  the   word
    "Language".  Pressing  the "L" key will  scroll  through  the
    language selections currently supported by Turbo ScrEdit.

    PRESS "L" (a few times)

    Notice  that  each time you press the "L" key,  the  language
    description  changes.  The programming  language  that  Turbo
    ScrEdit  will use when creating source code is  displayed  on
    this line. Languages currently supported are:

        Turbo Pascal 3.0, 4.0, 5.0
        Turbo C      1.5, 2.0

    Now select your language before continuing on.

    Next  you  will specify for Turbo ScrEdit what  default  data
    type  it  will  use for any new fields on  a  screen.  It  is
    important  that you understand here that these defaults  will
    only  apply  to any field names that have been added  to  the
    screen  since the last time it was compiled. Any field  types
    that  have  been  assigned to screen  fields  in  a  previous
    compile session will remain as they were originally defined.
    Locate the line on the screen that begins with a  highlighted
    "F"  in the word "Field Type". There are nine  possible  data
    types:
      0   : Integer values (A real number with decimals truncated).
      2-7 : Specifies  the  absolute  decimal  position  for  the
            field.
      8   : Alphabetical characters (A-Z,a-z,space).
      9   : Any keyboard character is accepted.

   PRESS "F" (a few times)

    Notice  that  each time you press the "F"  key   a  different
    field  type  is described. For type 0 thru 7  an  example  is
    shown  that  illustrates the position of or  absence  of  the
    decimal  position. For instance with a type of 3 the  example
    shows  "0000.00".  The decimal position is  in  the  absolute
    third position of the field.

    PRESS "F" (until the line shows <3> and 00000.00)

    With  this setting all the new fields on the screen  will  be
    defined  as  numeric fields of type real. Of course  we  know
    that the fields in the name and address section of the screen
    certainly  will not contain numeric values. But we  will  fix
    that  in  a  minute. The important thing  here  is  that  the
    default we selected will meet the need for most of the fields
    on the screen.

    Next,  locate  the last line that begins with  a  highlighted
    "D".   Use  the  "D" key to set the  default  field  type  to
    either "data entry fields" or "display only fields". The term
    "data  entry" means that the user of your program  will  type
    a value into the field on the screen. The term "display only"






                             Page  24

    means  that your program will only be able to show  the  user
    information in these fields. The user of you program will not
    be  able to change the contents of a display only  field,  he
    can only look at it. When the words DATA ENTRY are  displayed
    in  upper  case, all new fields  will default to  data  entry
    fields.  When the words DISPLAY ONLY are displayed  in  upper
    case the field will not allow data to be entered into it.

    PRESS "D" (a few times..Stop when the line reads
                "display only/DATA ENTRY")

    Now on the bottom of the screen we see the prompt:

    "Accept values as shown? (Y)  F1=Help".

    Before you continue make sure that the language type is set
    correctly for your compiler, and that the default field type
    is set to 3 (00000.00), and that field type will be DATA
    ENTRY. When you have check these values you may continue.

    PRESS "Y"

    Turbo  ScrEdit will perform a number of checks on the  screen
    as  it compiles it. If any error conditions are  detected  an
    error  listing  will be displayed. Study the  error  messages
    before  returning to the main menu, or if you prefer you  can
    print  a hard copy listing of the errors.  Pressing  any  key
    will  return  you to the main menu where you can use  the  F2
    option to make the needed corrections to the screen.

    When  the  screen compiles successfully, Turbo  ScrEdit  will
    display  the top portion of the screen with the first  field,
    "Yr_1", underlined with a row of carats "^^^^^".

    Notice that the row and column position of the field, and the
    length,  type,  and  display type for this  field  are  being
    displayed.  The blinking cursor is on the type field.  Inside
    the type section of the screen you will see descriptions  for
    the value that is allowed in the type field (0, 2 thru 9).

    This  is a year field, we know that year will be  an  integer
    value so we must change the "3" to a "0".

    PRESS 0

    The cursor advanced to the field labeled "display only". Lets
    make all the purchase history fields on this top line display
    only.

    PRESS "D" and PRESS ENTER

    PRESS TAb
    PRESS "D" and PRESS ENTER

    PRESS TAb
    PRESS "D" and PRESS ENTER

    PRESS TAb






                             Page  25

    PRESS "D" and PRESS ENTER

    PRESS TAb
    PRESS "D" and PRESS ENTER

    The  cursor  should now be on the field "Yr_2"  on  the  next
    line.  Define this field as 0 then PRESS the ENTER key  until
    the line of carats underlines "Yr_3". Define "Yr_3" as 0 also
    and  PRESS  the  ENTER key until the carats  under  line  the
    "Name_Field".

    As the name implies, this is a name field so we know that  we
    must be allowed to key in alphabetical characters and in some
    cases numbers.  We need to change the default from 3 to 9  so
    we can key any characters into this field.

    PRESS "9" and PRESS ENTER

    The next field "Address_Line_1" is now displayed with the row
    of carats under it. Address_Line_1 and Address_Line_2  should
    also allow any key to be keyed into it. Change them to type 9
    also.

    PRESS "9"
    PRESS ENTER
    PRESS "9"
    PRESS ENTER

    Now  "City"  is  the field that is underlined by  carats.  We
    will restrict this field to only allowing alpha characters:

    PRESS "8"
    PRESS ENTER

    For "St" lets do the same:

    PRESS "8"
    PRESS ENTER

    The  phone  fields should be defined as integer  type  0.  No
    decimals  will  be allowed in these fields. Enter  zeros  for
    each of these fields.

    Now turn your attention to the function key labels that  fill
    the middle of the screen.

    PRESS F1 (Help)

    A help menu is displayed notice that pressing different  keys
    will give you help on different topics about using the screen
    compiler. If you press one of these keys you will invoke  the
    on-line help system and the topic that corresponds to the key
    will be displayed.

    PRESS ESC - to return to the compiler screen.

    PRESS F5







                             Page  26

    Pressing this key will always place the  line of carats under the
    first field of the screen.

    PRESS F6

    Pressing this key will always place the line of carats under the
    last field of the screen.

    PRESS F7 (a few times)

    Pressing this key moves the carat prompt to the previous field
    on the screen.

    PRESS F8

    Pressing this key moves the carat prompt to the next field on the
    screen.

    As  you  can  see the F5, F6, F7, and F8 keys  allow  you  to
    scroll around through the screen fields. Be aware that if you
    press  the F8 key when the carat prompt is positioned on  the
    last field of the screen you will end the compile and  return
    to the main menu.

    Now  I  want to give you a taste of using  screen  validation
    procedures.  Let's  define  a  user  help  message  for   the
    "Name_Field", and make it a required field. Don't worry about
    understanding  the  next few instructions just  now.  I  will
    explain them to you later in detail.

    Scroll  through the fields until the line of carats is  under
    the field "Name_Field".

    PRESS F2

    The  middle  line  in the bottom portion of  the  screen  has
    changed  to  a  highlighted field with  the  blinking  cursor
    waiting in it. Notice also that the function key labels  have
    changed. On the bottom line of the screen the keyboard toggle
    key status is displayed.

    TYPE  HELP  'Fill out this field with a customer  name.'  and
    PRESS ENTER

    TYPE "REQUIRED" and PRESS ENTER

    PRESS ESC

    The  highlighted field has disappeared but the lines that  we
    typed are still displayed.

    We are done for now so lets return to the main menu:

    PRESS ESC

    A series of messages will be displayed as ScrEdit creates the
    source  code for the screen buffer, and performs  the  "house
    work"  in  the screen file. The time taken to do  the  "house






                             Page  27

    work"  will increase as the number of screens in  the  screen
    file  increases.  When  ScrEdit is finished,  the  main  menu
    screen is displayed.

Now that the screen is compiled we can test it.

- Testing a screen -

PRESS F10 - The test screen option of the main menu.

    Your  screen  is displayed, notice that all the  fields  have
    been removed, and the cursor is positioned on the name field.
    The phone number fields now have zeros in them and the fields
    in  the  purchases  history section of the  the  screen  show
    ".00".

    PRESS TAB (a few times)

    Notice  that  pressing the TAB moves the cursor  through  the
    fields  on  the  screen in left to right and  top  to  bottom
    order.

    PRESS SHIFT and TAB (a few times)

    Now the cursor moves to the previous field on the screen each
    time these keys are pressed.

    PRESS ENTER

    The cursor moves to the name field and a message is displayed
    on  the  bottom  line saying that  this  field  is  required.
    Remember  the REQUIRED statement that we associated  to  this
    field?  Later  we will take an in-depth look at  using  field
    validation statements, and how they work.

    TYPE A ? and PRESS ENTER

    We  see  that our help message is displayed. You  can  assign
    help text to any data entry field on a screen.

    PRESS TAB to move to the first address field.

    TYPE A ? and PRESS ENTER

    A  message  is displayed that says no help is  available  for
    this field. This is the default message that the user of your
    program will see if he try's to get help on a field that  has
    no help message assigned to it.

    Turbo Scredit allow extensive field validation. We will  take
    a closer look at these features in PART TWO of this tutor.

    Next  notice  that  by default when you enter  a  screen  the
    cursor is always positioned on the first data entry field  of
    the  screen. Notice also that the cursor  moves to  the  next
    field to the right of the current field each time the TAB key
    is  pressed. Or if you use SHIFT and TAB the cursor moves  to
    the  field to the left of the current field. The  order  that






                             Page  28

    fields  are accessed by default is top to bottom and left  to
    right. In some cases you will want to change this order. Take
    this screen for instance. It would be nice to have the cursor
    begin on the name field. Next lets look at how Turbo  ScrEdit
    allows you to redefine this order.

    PRESS ESC.

The main menu is displayed.

- Changing a screens field order -

PRESS F6 - The resequence field order option of the main menu.

    The main menu screen is replaced again by our screen.

    PRESS SHIFT F1

    Read this section about changing the field processing  order.
    When you are finished PRESS ESC to return to our screen.

    Your goal here will be to make the cursor  begin on the  name
    field  of  our  screen and move through  the  address,  city,
    state,  zip  and  phone  section  of  the  screen,  then  the
    purchasing information.

    Hint:  Use the TAB key to place the cursor on the name  field
           and:
           PRESS ENTER
           PRESS SHIFT TAB
           PRESS ENTER
           PRESS SHIFT TAB.
           PRESS ENTER

    Continue until you have pressed the ENTER key on every  field
    of the screen.  Notice as you proceed from field to field and
    press the ENTER key that the field indicator on the bottom of
    the screen is counting the number of fields defined. When you
    are  finished you will automatically be returned to the  main
    menu.

PRESS F10 - The test screen option of main menu.

    This  time the prompt should start on the name field  on  the
    screen. Pressing the TAB key should cause the cursor to  move
    through  the  rest of the address fields and then jump up  to
    the YR_1 field.

    PRESS ESC when you are finished playing.

- Changing the field color attributes -

There is one more area with which you can customize the way  your
screens are processed. Each field of the screen will always be in
one of three possible states:
-  a field can be empty (lets call this "normal"),
-  a  field  can  be  receiving  key  strokes  (lets  call   this
   "prompt"),






                             Page  29

-   or  a  field  can  be displaying  a  value  (lets  call  this
   "display").

Turbo  ScrEdit allows you to define a different  color  attribute
for  each  of  these three states. By default  empty  fields  and
fields that contain data will be displayed in the color that  was
used  when  the  screen was created, and by  default  when  Turbo
ScrEdit  is accepting data into a field the background  color  is
black (0) and the foreground color is set to bright white (15).

Thus  we  have  three states for a  field;  normal,  prompt,  and
display.  You  can change the color attributes for  "prompt"  and
"display".  "Normal" will always be whatever color you used  when
you originally designed the screen.

PRESS F8 - The change field color option of the main menu.

    The  main menu screen is replaced by the screen that  we  are
    editing. You will see one field on the screen that is  filled
    with small dots. This is the prompt field for this screen. To
    modify a fields colors you must first place the prompt in the
    field  to be changed. You can use the Tab and SHIFT TAB  keys
    to move from field to field.

    The  status  line  is displayed on the  bottom  line  of  the
    screen. Locate the labels [Normal], [Prompt], and  [Display].
    To the left of each of these labels you will find two  fields
    surrounded by greater than and less than symbols and prefixed
    by  a  "B"  or "F". These fields  will  display  the  current
    "B"ackground  color and "F"oreground colors for  the  current
    field in each of it's three possible states.

    Notice  also the blinking arrow by the [Prompt].  This  arrow
    indicates that you will be changing the color definitions for
    the  [Prompt]  state. By pressing the keypad  left  or  right
    arrow  keys  this  arrow will  toggle  between  [Prompt]  and
    [Display].

    **  NOTE  ** Turbo ScrEdit will not allow you to  define  the
    prompt  color  for a field that has been defined  as  DISPLAY
    ONLY.

    PRESS SHIFT and F1.

    Read  the  help section on changing field  color  attributes.
    Lets  change some of the field colors to whatever appeals  to
    you. I will step you through the first one.

    PRESS ESC to return to our screen.

    Use the keypad arrow keys to position the blinking arrow next
    to the [Prompt] part of the status line.

    PRESS HOME.

    When  you  pressed  HOME, the current screen  field  and  the
    status line [Prompt] label should have changed to reflect the
    new color codes.






                             Page  30


    PRESS RIGHT ARROW.

    The  blinking arrow now has moved to the DISPLAY part of  the
    status line.

    PRESS HOME twice.

    This  time  the [Display] label on the status  line  and  the
    current  field is changing to show the display color.  Select
    any  color combination that you wish for this fields  display
    state.

    Move  the cursor to another field and define the  colors  for
    that field. Continue for as many fields on the screen as  you
    wish to practice on.

    PRESS ESC to return to the main menu when you are finished.

Next we can return to the screen test mode and see how the screen
uses the colors we defined.

PRESS F10 - The test screen option of the main menu.

    Try  typing  values into the screen fields  and  erasing  the
    values  from  the fields (Backspace) and see how  the  colors
    change.  Remember  you  must type only  numbers  for  numeric
    fields.

    PRESS ESC when you are finished.

You  should now be looking at the main menu screen  again.  There
are  still  three main menu options that we have  not  discussed.
Next Lets look at how you can get a hard copy of your screen.


- Printing a screen listing -

** Skip this section if you do not have a printer **

PRESS F5 - The screen listing main menu option.

    On the bottom line of the screen you are offered a chance  to
    cancel the print screen option. If you press ESCape the print
    operation is aborted.

    PRESS ENTER

    The screen listing will be printed on your printer.


-  Copying text from other screens -

When  you are developing a system that has several  screens,  you
may want to copy all or portions of other screens into the screen
that you are editing. Turbo ScrEdit provides a way of doing this.

Scroll  the screen "Test_Three" to the edit screen line. This  is






                             Page  31

the  screen that you experimented with. It should still have  the
lines  and  boxes  in it that we placed  there  in  the  previous
example on editing screens. This will be the "target" screen that
we want to copy text to.

Next we will define the "source" screen that we want to copy text
from.  Locate  the section of the screen labeled  "Copy  Screen".
This  section of the screen is used just like the  "Work  Screen"
area  is used. Only Here we define the screen files  and  screens
that we want to copy text from.

PRESS F3 - The define copy screen main menu option.

    The blinking cursor is now waiting on a blank line inside the
    copy  screen  section. At this point you could  type  in  any
    screen file name that exists on your system. You can  include
    drive  and path information if necessary. For the purpose  of
    this  example we are going to use the same file that  we  are
    editing:

    TYPE "TESTSCR" and PRESS ENTER

    The  copy screen file is opened and the screens in  the  file
    are displayed.  You can use the PgUp and PgDn keys to  scroll
    the copy screens in the window. The screen name that  appears
    in the highlighted line is the screen will be the source that
    you will be copying screen text from.

    Use the PgUP key to scroll "Test_One" to the top line of  the
    screen names window.

    PRESS F2 - The edit screen main menu option.

    The  main  menu  disappears  and the  first  screen  that  we
    experimented with, "Test_Three" is displayed on the screen.

    PRESS F6.

    This  time the screen "Test_One" is displayed on the  screen.
    So  we see that when a "Copy Screen" is defined on  the  main
    menu,  it becomes the screen that is accessed in  the  screen
    editor when we perform text copy or move functions.

    Answer the prompt with your choice and copy a portion of  the
    text into our edit screen.

    PRESS ESC when you are finished.

    PRESS "Y" to save our work.

PRESS F3.
PRESS ENTER.

    The copy screen line has returned to "Undefined". If you were
    to re-enter back into the editor, and access the copy  screen
    again,  you would find that the copy screen has  returned  to
    the current screen that is being editing.







                             Page  32

- Generating source code -

Now that you have used all the options that apply to editing  and
creating  a screen, lets press on and let Turbo ScrEdit  generate
the source code necessary to access and use the screens that  you
have developed.

PRESS "G" - The generate source code main menu option.

    The  source  code  generation  screen  is  divided  into  two
    sections.   The  top  section  is  labeled  "ScrEdit   Source
    Generation  Configuration".  The bottom  section  is  labeled
    "Source Code Generation Screen  Selection".

    - Selecting a source code language -

    First lets look at configuring the source code generator. The
    blinking  cursor should be position in the "Language"  field.
    Notice that below the prompt there is text that describes the
    acceptable values for this field.

    PRESS PGDN (a few times)

    Notice that the different language possibilities are scrolled
    into  the  language field each time you press PGDN.  You  can
    also type in the label that describes your compiler.

    Set  the  this value for your compiler. You can use  PGDN  to
    select  the  label that describes your compiler, or  you  can
    type code you select from the list in the field  description.
    If  you type in a code the prompt will automatically  advance
    to  the next option. If you use PGDN to make  your  selection
    your will have to press the TAB key.


    - Suppressing skeleton file comments -

    The  skeleton  files that comes with Turbo  ScrEdit  contains
    numerous comments that are designed to help you begin merging
    your  logic into the code that Turbo ScrEdit generates.  When
    you  become  proficient  with using Turbo  ScrEdit  you  will
    probably want to suppress the comments.

        If  you place a "Y" in this field, most of  the  comments
        in  the skeleton will not be included in the source  file
        generated.

        For now we do not want the comments to be suppressed so:

        PRESS "N"

    - Options for using screen buffers -

    Next  we  must  decide if we want the screen  buffers  to  be
    copied  into our source code or if we want them  included  at
    compile time. Again, the possible answers for this option are
    described below the prompt line.







                             Page  33

        If  you  answer  this prompt with a  "Y",  all  the  code
        necessary  to  define and initialize the  screen  buffers
        will be copied directly into the generated source code.

        If  you  answer with "N" the source code  generator  will
        place {$I} include compiler directives in the source code
        and  the screen definitions will be included  at  compile
        time.

        Let's have  the screen definitions copied into  the  file
        that we are going to generate.

        PRESS "Y"

    - Controlling character case -

    Next you can specify the character case that the code will be
    generated in.

        If  you  answer this prompt with a "U"  then  the  entire
        source file generated will be in upper case characters.

        If  you reply with "M" then the source will be  in  mixed
        upper  and lower case just as it appears in the  skeleton
        file.

        If  you  are programming in "C" use the  "M"ixed  option.
        Upper  case   characters  will not compile  with  an ANSI
        standard "C" compiler.


    - Specifying the skeleton file locations -

    Finally  you must tell Turbo ScrEdit where it can locate  the
    skeleton   files  that  it  must  use  during   source   code
    generation.

        Specify the drive and path where you have stored the files
        "Skeleton.C" or "Skeleton.P".

    Okay, we have now configured Turbo ScrEdit for your  personal
    needs.  Turbo ScrEdit will remember these settings until  you
    change them again.

    Next we will want to select the screens that will be accessed
    in the program Turbo ScrEdit is about to generate. Locate the
    "Source  Code  Generation Screen Selection"  section  of  the
    screen.

    Notice that the screens in the screen file are displayed in a
    small window. Also notice that the first screen in the window
    has  an arrow to its left. When Turbo ScrEdit sees  a  screen
    name  that  is flagged with this mark it  will  generate  the
    necessary code to access the screen. You may flag one or  all
    the screens in a screen file.

    The  up and down arrow keys are used to move the  highlighted
    bar  from one screen name to another. We know that  there  is






                             Page  34

    another  screen  in  this file so let's scroll  it  into  the
    window.

    PRESS UP ARROW - until all the screen names are in the window.
    PRESS HOME (a few times)

    Each time you press the HOME key, a mark appears next to  the
    screen name and the highlighted bar moves to the next field.

    PRESS UP ARROW (until the highlighted bar is on  the  first
                    screen name).
    PRESS END (a few times)

    Each  time you press the END key the mark next to the  screen
    name  disappears  and the highlighted bar moves to  the  next
    screen name.

    Now  use the arrow keys and HOME key to flag  "Test_One"  and
    "Test_Three"  for  inclusion in the  source  code  generation
    process.

    PRESS ENTER

    The  message "GENERATING SOURCE CODE" should be  flashing  on
    the  bottom  line  of the screen. When it  is  Turbo  ScrEdit
    finished generating the program, you will be returned to  the
    main menu.

PRESS ESC to exit Turbo ScrEdit back to DOS.

Take time now to load the program generated by Turbo ScrEdit into
you  favorite  editor  and examine the  source  file  that  Turbo
ScrEdit  generated. Load "TestScr.Pas" or "TestScr.C",  depending
on the type of compiler you are using, into you editor. Take time
to examine the source code Turbo ScrEdit has generated. When  you
are done looking over the code, compile and run the program.

Try  keying data into the screen fields, and  pressing  different
combinations  of  special control keys. You will see  that  Turbo
ScrEdit  lets  you easily detect almost any  combination  of  key
strokes.

Well, that concludes the basic look at Turbo ScrEdit. You  should
now  be able to produce any screens that you need, and  generates
the basic skeleton program ready to receive you custom logic.  In
the next part of this tutor we will look at the field  validation
language that is supported by Turbo ScrEdit.



PART TWO

In PART ONE you learned  how to create a screen file, create  and
edit  screens,   compile  a screen,  change the  order  that  the
screen  fields  are processed,  change the  display,  and  prompt
colors, test a screen, and finally, how to tell scredit to create
the source code needed to use the screen file.







                             Page  35

In  PART  TWO we are going to take a closer look at some  of  the
ways that you can use ScrEdit's field processing language to edit
the  values  that are allowed to be keyed into the  fields  on  a
screen.

We  will use the files "SCRDEMO.SCR" and "SCRDEMO.P" if  you  are
using  pascal,  or "SCRDEMO.C" if you are using a  "C"  compiler.
These files came with Turbo ScrEdit for the examples that follow.
Copy  these  two  files to a separate work area,  or  to  a  work
diskette.

Lets begin by looking at "SCRDEMO.SCR", the demonstration  screen
file  that came with Turbo ScrEdit. By now you should be able  to
run Turbo ScrEdit and load this screen file on your own.

We find that there are two screens in this file, "Demo_Menu"  and
"Demo_Screen".

First lets look at the screen "Demo Menu". Scroll "Demo_Menu"  to
the  top line of the screens window and press F2 to look  at  the
screen.  This screen has no fields defined on it. It is  just  an
introduction to the demonstration program. Screens with no fields
on them can be used for pop up help screens or for menu screens.

PRESS ESC
PRESS "N"

Even  screens that don't have any fields must be compiled  before
they can be accessed in your program.

PRESS F4

    When  Turbo ScrEdit compiles a screen with no fields  on  it,
    it  sets  a flag in the file index that tells  Turbo  ScrEdit
    not  to  generate a buffer for the screen, and never  try  to
    read  or write any data to or from this screen. A  screen  of
    this type will not take up any memory in your program. It  is
    read  into the file buffer when needed then overlaid  by  the
    next screen displayed.

    Because it has no fields, and consequently requires no buffer
    to  be  generated, the value of  the  compiler  configuration
    option will have no effect on this screen.

    PRESS "Y" to accept the values.

    The compile process begins and because there is no fields  on
    the  screen to define you are returned directly to  the  main
    menu.

Now move "Demo_Screen" to the highlighted screen name line.

PRESS F2 to look at "Demo_Screen".

     When  you are finished looking at the screen return  to  the
     main menu.

     PRESS ESC






                             Page  36

     PRESS "N"

The  next  thing that we will do is  compile  "Demo_Screen".  The
purpose  of  this demonstration is to give  you  some  experience
using field processing specifications. Each of the fields on this
screen  have  previously  been defined  and  assigned  processing
specifications.  Basically  I just want you to look  at  how  the
specifications  are defined and allow me to describe their  usage
and purpose to you.

PRESS F4 key to compile the screen.

    For  the  purpose of this demonstration you must  select  the
    language for your compiler.  There will not be new fields  on
    this screen so the rest of the prompts not have an effect  on
    this  screen.  You  may accept the values  as  they  are  now
    displayed.

    When  the compile is finished, the first field found  on  the
    screen  will  be  displayed with a  row  of  carats  (^^^^^^)
    underlining  it.  In  this case the field name  is  "OP"  for
    option.

    The blinking cursor is sitting on the field labeled "Type".

    Through out this discussion I will ask you to use the on-line
    help  system  to  lookup  and read  the  details  on  certain
    statements.

    We see the current field "OP" has a type of "0" meaning  that
    "OP"  is an integer field so Turbo ScrEdit will  only  accept
    numeric keystrokes to be keyed into this field.

    In  the  bottom section of the screen we see  five  lines  of
    text:

    ----------
    HELP 'Each field on the screen can have a help message accessed by
          a ? mark'
    REM
    REM statements. These comments are ignored by Turbo ScrEdit.
    REM
    IN '1^4'\' You must select one of the options 1 through 4 '
    ----------

    These are field processing statements. Turbo ScrEdit supports
    a  variety  of processing statements that will allow  you  to
    test each field for specific values or ranges of values.

    ScrEdit  allows  up  to 50 lines of these  statements  to  be
    assigned  to each field on the screen. It is not  recommended
    that  you  assign  every  field on the  screen  50  lines  of
    processing   statements.  These  processing  statements   are
    interpreted  by  Turbo ScrEdit, which means you can  over  do
    using them and make your screen sluggish. By the same token I
    believe  you  will surprised by how may  statements  you  can
    assign  to a screen with no noticeable effect of speed.  When
    you  use  processing statements you will want  to  experiment






                             Page  37

    with them and be as precise as possible.

    PRESS F2 to start editing the processing specs.

        The  control  key labels have changed  to  represent  new
        functions.  The  first line of text is  now  highlighted,
        with  a blinking cursor to the right of the text  on  the
        line.  This is the processing statement editor. In  this
        mode we can add, delete, or edit processing statements.

        Lets look at each of the control keys for this screen.

        F1 - will  call up a help system menu. This is  a  little
             different  approach than used in most of  the  other
             screens  of  Turbo ScrEdit. From this menu  you  can
             access  the  information on how to  define  and  use
             processing specifications.

        F2 - deletes the line at the cursor.

        F3 - inserts a blank line at the cursor.

        F5 - places  the cursor on the first line  of  processing
             specifications for the field.

        F6 - places the cursor on the last line of the processing
             specifications for the field.

        F7 - advances the cursor to the next line of text.

        F8 - Moves the cursor up one line of text.

        ESC - ends the processing specs editor and returns you to
             field definition mode.

        ENTER - moves the cursor to the next line of text.

        Notice  on the bottom line of the screen some  additional
        keys are described.

        DEL - (key  pad  "."  or delete key) is  used  to  delete
              characters at the cursor.

        INS - (key  pad  "0"  or insert key) is  used  to  toggle
              insert mode on and off. When insert mode is on, any
              characters typed will be inserted into the line.

        LEFT ARROW - (key pad "4") is used to move the cursor  to
              the left in the line of text.

        RIGHT ARROW - (key pad "6") is used to move the cursor to
              the right in the line of text.

        The first statement used here is the HELP statement.  You
        probably  remember how the HELP statement works from  our
        discussion in PART ONE. Let's look up the HELP  statement
        in the on-line help system and read up on it.







                             Page  38

        PRESS F1
        PRESS F8

        Read the manual's description on the HELP statement.

        PRESS ESC to return to the help menu.
        PRESS ESC to return to the compile screen.

        - Using the HELP statements -

        Help  statements  are optional. If a  HELP  statement  is
        assigned to a field it must be the first field processing
        statement.  The HELP statement consists of the word  HELP
        followed by a message enclosed in single quotes.

        Any time a ? mark is typed in the field and the ENTER key
        is pressed, Turbo ScrEdit checks for a HELP statement. If
        a HELP statement is found the help message is  displayed.
        If  no  help statement is assigned to  the  field,  Turbo
        ScrEdit  displays the message "No help defined  for  this
        field".

        PRESS F3 (two times)

        Two  blank  lines  have been insert  ahead  of  the  HELP
        statement.

        PRESS F2 (two times)

        The two blank lines have been deleted.

        Use the right arrow key to place the cursor between  HELP
        and the message that follows it.

        PRESS INS  (key pad 0) until the [INSERT] label  on  the
                    bottom of the screen is highlighted.

        TYPE in a couple of characters.

        Notice  that the characters you typed have been  inserted
        into  the  line of text. In insert  mode  characters  are
        truncated as they are pushed off the end of the line.

        Use the left arrow key to position the cursor back on the
        first character that you typed.

        PRESS DEL  (key pad ".") and delete the  characters  from
                   the line.

        Use the right arrow to move the cursor to the end of  the
        line  and  make  sure that the line ends with   "by  a  ?
        mark'".

        PRESS F6

        The  last  line of processing specs is now  on  the  edit
        line.







                             Page  39

        PRESS F5

        The  first  line of processing specs is now on  the  edit
        line.

        PRESS F8

        The  text is moved up one line so the first REM  line  is
        now  on the edit line. Look up the REM statement  in  the
        on-line help system. (PRESS F1 followed by SHIFT F7).

        - Using the REM statements -

        You see that you may add remarks to your field processing
        statements. Remarks are ignored by Turbo ScrEdit and will
        only  be  displayed  on this screen  and  in  the  screen
        listing (the main menu F5 option).

        PRESS F8 (three times)

        Now a line that starts with "IN" is in the edit line. Use
        the on line help system to look up "IN" statements.

        - Using the IN statements -

        We see that IN statements are used to test the value of a
        field against a list of values. In this case we are going
        to compare the value of OP against a range of values from
        1 to 4. This same expression could have been written as:

        IN '1'2'3'4'\ message

        This  would work just the same as using the  range  value
        '1^4'.

        The '\' means "NOT EQUAL TO". So if the value keyed  does
        not fall within the range's of 1 to 4 Turbo ScrEdit  will
        consider the field contents invalid, and the message will
        be issued to the user.

        If  you  were to replace the '\' with a '=' then  if  the
        value  of OP is found to be in the range of 1 to 4  Turbo
        ScrEdit  will consider the value invalid and the  message
        will be issued to the user of the program.

        In plain english these expressions are saying:
            If  the user types a question mark in this field  and
            presses the enter key, display the  help message,  or
            if  the  user types any value in this  field  besides
            1,2,3,4 or ? reject it and issue the error message.

        PRESS ESC to exit the edit process mode

    PRESS F8 to advance to the next field on the screen.

    PRESS F2 to Look at the next fields processing specifications.








                             Page  40

        The  first  statement that we see defined here is  an  UP
        SHIFT ON statement.

        - Using the UP SHIFT statement -

        Using  the  UP  SHIFT statement will  control  how  Turbo
        ScrEdit  performs alphabetical comparisons. The UP  SHIFT
        statement  is followed by either ON or OFF and will  have
        following affect:

            UP SHIFT ON  - All   alphabetical  comparisons   that
                           occur after this statement and  before
                           the next UP SHIFT OFF statement   will
                           be   performed  with  no   regard   to
                           character case.

            UP SHIFT OFF - All   alphabetical   comparisons  that
                           follow  this  statement will  be  made
                           according  to the character case  that
                           they are entered in.

        Turbo  ScrEdit will reset itself to UP SHIFT OFF  between
        fields.  When  Turbo ScrEdit begins evaluating  a  fields
        processing specifications, UP SHIFT OFF is assumed,  even
        if you had used an UP SHIFT ON for the previous field.
        PRESS F8 to advance to the next processing line.

        The  next statement we find is an IF statement.  We  must
        discuss  the  IF,  THEN,  and  ENDIF  statements  as  one
        statement.  Before we dive into the discussion take  time
        to  look up the IF statement in the on-line help  system,
        and read the explanation carefully.


        - Using the IF/NOT/THEN/SKIP/ENDIF statements -

        The IF statement allows you to check the status of  other
        fields  on  the screen for  specified  conditions  before
        testing  the  current fields values.  If  the  conditions
        specified  between  the IF and the THEN are  analyzed  as
        true  then the statements between the THEN and the  ENDIF
        if are performed. If the expression is analyzed as  false
        then  everything is ignored up to and through  the  ENDIF
        statement.

        In this example we are testing the value of OP by  saying
        that if the value of OP is NOT equal to '1' THEN we  want
        to  perform the expressions of the IF statement. In  this
        case the word SKIP is the expression to be performed.

        If  the  value of OP is equal to '1' then  Turbo  ScrEdit
        will  read ahead to the next statement that  follows  the
        ENDIF.

        - SKIP statement -

        The  SKIP statement means SKIP this field and advance  to
        the next.






                             Page  41


        PRESS F8 (until you reach the IN statement)

        Next  we find another IN statement. Notice that the  list
        of  values  for this statement was too long to fit  on  a
        single  line. You can have values span as many  lines  as
        needed as long as the last value ends with a single quote
        and the one on the next line begins with a single quote.

        The  message  part of this IN statement is on a  line  by
        itself. The only rule that you must concern yourself with
        here is that the message line must begin with the '\' and
        end with the message enclosed in single quotes.

        In plain english these expression are saying:
            If the user has not entered a 1 in the field OP  then
            skip this field and go to the next.

            If  the user has entered a 1 in the field OP then  if
            the  value  in this field is not one  of  the  values
            listed  then  reject the value and  issue  the  error
            message.

        PRESS ESC to return to field definition mode.

    The   next  three  fields  on  the  screen  have   processing
    specifications that are almost identical to the ones that  we
    just  discussed,  so lets skip over them.

    PRESS F8 (three times)

    When we reach the field named "A", we see a SKIP IF BLANK
    statement.

    - Using a SKIP IF BLANK statement -

    This statement tells Turbo ScrEdit that if the current  field
    is empty it is to skip over the field.

    You  should recognize the remaining statements, they are  the
    same as those described above.

    PRESS F8 (three times)

    When  you  reach  the field named "D" stop  and  examine  the
    processing  statements of this field. We see that a new  type
    of  IF statement is coded here using the AND and  OR  logical
    operators.

    PRESS F2.

        The  first IF statement is a simple one similar to  those
        that we  have looked at before.

        PRESS F8 to scroll ahead.

        After the If statement we see a UP SHIFT ON statement.







                             Page  42

        The  next IF statement has some new additions to it,  the
        AND  and OR logical operators.

        - Using AND and OR operators -

        When  expressions  are tied together  by  AND  operators,
        Turbo  ScrEdit  will continue evaluating  expressions  as
        long   as  the  result  remains  true.  If  one  of   the
        expressions  evaluates to false then Turbo  ScrEdit  will
        read  ahead without evaluating any of the expressions  it
        encounters until an OR or THEN statement is encountered

        When an OR operator is encountered Turbo ScrEdit  recalls
        if the last expression evaluated was true or false.
        -  If  the  result  was  true  then  the  entire  IF   is
           considered  as true and Turbo ScrEdit will advance  to
           the  THEN part of the IF statement and  will  evaluate
           the expressions that make up the action part of the IF
           statement.
        -  If  the result was false then evaluation  begins  with
           the next expression after the OR.

        In  this  particular example the action part  of  the  if
        statement is the "ERROR" statement.

        - Using the ERROR statement -

        The  ERROR statement can only be used in the action  part
        of  an  IF  statement. When it is  encountered  an  error
        condition is assumed. Turbo ScrEdit will place the cursor
        on the current field, issue the error message and  return
        for a new value in the current field.

        You should be able to understand the remaining statements
        for this field.

        In plain english these statements are saying:
            If the field OP has any value other than 2 then  skip
            the remaining statements for this field and go to the
            next field.

            Otherwise  make  the following  comparisons  with  no
            regard to character case.

            If  any two of the fields A, B, or C are  blank  then
            issue  the error message and reject the  contents  of
            the screen.

            If  the screen is valid to this point then  test  the
            fields  A, B, and C to see if they all have a  value.
            If  none of them are empty then if the current  field
            also  is not empty issue the message and  reject  the
            screen.

            If  the  screen is valid to this point  then  if  the
            field "A" is blank, or if "B" is blank, or if "C"  is
            blank then the contents of the current field must  be
            a "D" or the error message is issued and the  content






                             Page  43


            of the screen is rejected.

        PRESS ESC to return to field definition mode.

    USE F8 again to scroll through the fields until you reach the
    field called "Date_Field". Take time as you move through  the
    fields to examine the processing statements for each of them.

    When you reach "Date_Field":

    PRESS F2 to examine the processing statements.

    Here  we  find  some familiar IF statements but  a  new  DATE
    statement.


    - Using the DATE statement -
    The DATE statement must be followed with at least one of  the
    patterns MM, DD, YY, or YYYY. These patterns can be  arranged
    any  way  you  desire, and separated by  any  characters  you
    specify.

    When  Turbo ScrEdit evaluates a date statement it checks  for
    valid  values for month (1-12) and valid values for day.  The
    valid value of day can vary for different months and  whether
    or not it is a leap year.

    The date keyed into the field must match the pattern that you
    use exactly or it is rejected.

    Turbo  ScrEdit will issue a variety of messages depending  on
    the condition that it finds in the date keyed.

    PRESS ESC to return to the field definition mode.

PRESS ESC. to return to the main menu.

As  you  return  to the main menu Turbo ScrEdit  will  display  a
series of messages on the bottom of the screen. Turbo ScrEdit  is
creating  the  screen  buffer to be  used  in  the  demonstration
program.


- Changing the sequence of the screen fields -

Use the main menu F6 option to reorder the way that Turbo ScrEdit
will process the fields on "Demo_Screen".  Notice that each  area
of  the  screen  has  a  number  in  the  top  left  corner  that
corresponds to the list of options.

The TAB and ENTER keys are used when redefining the screen fields
sequence:
    The TAB key is and SHIFT TAB keys are used to move the cursor
    from  field   to field.
    The ENTER key selects the current field as next field on  the
    screen.
    The ESC key ends the process and returns to the main menu.






                             Page  44


Use the TAB key to move the cursor through all the fields of  the
screen.  Notice when the cursor passes through the fields in  BOX
2, that between the fields "D" and "ABCD" the cursor jumps to the
field  in  BOX  4. Your task here will be to  reorder  the  field
sequence so "OP" is first, followed by the fields in BOX 1,  then
all  the  fields  in  BOX 2, followed by the  fields  in  BOX  3,
followed by the fields in BOX 4.

When  you have finished press ESC to return to the main menu  and
use the F10 option to test the screen.

PRESS ESC again to exit back to DOS.

Load the file "ScrDemo.P or ScrDemo.C" into your language  editor
and examine the code. If you are using Turbo Pascal you will want
to make the changes for your version outlined at the first of the
"ScrDemo.P". You may then compile the program and play with it to
see  how the processing specifications affect running  and  using
the program.

Well,  that  completes the introduction to ScrEdit.  I  hope  you
enjoy  using this program.  I would like to know what  you  think
about this tutor. Was it thorough, easy to use and follow, or was
it  difficult  to  follow or understand?   Please  send  me  some
feedback, let me know how you think it could be improved.

Send your comments to.
    iHn Systems
    P.O. Box 4436
    Pocatello, Id. 83205-4436