home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / utility / tpdesign / td1.doc < prev    next >
Text File  |  1989-03-01  |  71KB  |  1,800 lines
  1.          ____________
  2.              ____________
  3.                  ____________
  4.                  ____________           TURBO Designer    Part I
  5.              ____________
  6.          ____________
  7.  
  8.  
  9.          (c) Copyright 1987, 1988, 1989      Michael McMahon,
  10.                                              Attn: SLO-0000
  11.                                              878 Via Seville,
  12.                                              Livermore, California.
  13.                                              All rights reserved.
  14.  
  15.  
  16.                    Version 2.0 is copyright February 1989
  17.  
  18.                      DOCUMENTATION AND TUTORIAL V2.00
  19.  
  20.                  IMPORTANT: MAKE A BACKUP DISK IMMEDIATELY!!
  21.  
  22.  
  23.         Purpose of TURBO Designer part 1:
  24.  
  25.          In today's programming world, application programs which are to
  26.          be considered as being top-quality must be easy to use. Users
  27.          don't want to learn cryptic keystroke commands when there are
  28.          better methods  available, such as pop up and pull down menus.
  29.          Windows systems, however, can take weeks and even months to
  30.          design and debug and implement properly, but with TURBO Designer
  31.          part 1 version 2.0, a COMPLETE ENVIRONMENT WITH WINDOWS can be
  32.          created in a matter of minutes.
  33.  
  34.         System requirements:
  35.  
  36.             1.   IBM PC/XT/AT/jr PS/2  or 100% compatible
  37.                  512k memory or more.
  38.                  Two floppy disk drives or a hard disk based system.
  39.  
  40.             2.   TURBO Pascal v4.0 or greater.
  41.  
  42.         DISCLAIMER:
  43.  
  44.         TURBO Designer I is  distributed  "as is" , with no guarantee that
  45.         it will work properly in any or all situations. The Author assumes
  46.         no liability for any damages, financial or hardware, because of the
  47.         use or misuse or abuse of this product or any modification of this
  48.         product. The Author assumes no liability  for any errors caused by
  49.         accuracy or inaccuracy of the documentation.
  50.  
  51.  
  52.               TURBO Pascal is a trademark of BORLAND International.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                              Page  1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.               ACKNOWLEDGEMENT:
  81.  
  82.  
  83.                  To Mark Edson, for without his unselfish support,
  84.  
  85.               version 2.0 would still be a vision.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                              Page 2
  121.  
  122.           TABLE OF CONTENTS
  123.  
  124.              INTRODUCTION ..................................... 4
  125.  
  126.              What's in a menu? ................................ 5
  127.  
  128.              TURBO Designer's Pull down menu system ........... 8
  129.  
  130.              Getting started
  131.                  Installing TD1 ............................... 11
  132.                  Loading TD1 .................................. 11
  133.  
  134.              Design Menus
  135.                  Designing Pull down menus .................... 12
  136.                  Designing horizontal pop up menus ............ 13
  137.                  Designing vertical pop up menus .............. 14
  138.  
  139.              Color constants and your program's environment
  140.                  Setting your program's colors ................ 15
  141.                  Setting your program's environment ........... 16
  142.  
  143.              Help screen definitions
  144.                  Edit help screen definitions ................. 16
  145.                  Edit help screen text ........................ 17
  146.  
  147.              A sample session ................................. 18
  148.  
  149.              Using TD1 as a library ........................... 24
  150.                   Function CalcColor........................... 24
  151.                   Function MonoColor........................... 25
  152.                   Procedure Wr................................. 25
  153.                   Procedure MkWin.............................. 25
  154.                   Procedure RmWin.............................. 26
  155.                   Procedure Help............................... 26
  156.                   Procedure Directory.......................... 26
  157.                   Procedure TrashFile.......................... 26
  158.                   Procedure TrashGroup......................... 26
  159.                   Procedure EditTrash.......................... 26
  160.                   Procedure EmptyTrash......................... 26
  161.                   Function GetFileName......................... 26
  162.                   Procedure Error.............................. 26
  163.                   Procedure Do_Clock........................... 27
  164.                   Procedure ChangeDir.......................... 27
  165.  
  166.              ShareWare and TURBO Designer...................... 27
  167.  
  168.              Distributing TURBO Designer....................... 28
  169.  
  170.              Files on this disk ............................... 29
  171.  
  172.              Registration form ................................ 30
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                              Page 3
  181.        INTRODUCTION
  182.  
  183.         What IS TURBO Designer?
  184.  
  185.         Any non-trivial program can be broken into three parts: Input,
  186.        Processing, and Output. In theory, there may be strong emphasis
  187.        on any of the three parts. In practice, however, the emphasis is
  188.        usually centered on functionality (all of the "Processing" part
  189.        and some of the "Output" part), with sometimes as little as an
  190.        afterthought given to the other parts, of which the user-
  191.        interface is comprised. This may not be too bad, since a
  192.        program's significance can be measured primarily by it's
  193.        functionality. However, the lack of a satisfactory user-interface
  194.        severely hampers the marketability and market appeal of the
  195.        product and critically constrains the scope of potential users.
  196.        The problem which arises is this: should the programmer
  197.        concentrate his/her allotted time on producing an elaborate user-
  198.        interface, or producing a program which can perform sophisticated
  199.        tasks?
  200.  
  201.         In today's software market, companies hire multiple teams of
  202.        programmers to make programs which are both sophisticated and
  203.        marketable. "Lone wolf" programmers are rare in today's market,
  204.        simply because individuals cannot compete with the market today,
  205.        producing sophisticated user-friendly programs.
  206.  
  207.         The majority of applications programs produced have failed; not
  208.        because of a lack of functionality, but because either the user-
  209.        interface was clumsy, or they were not adequately upgraded. The
  210.        main function of TURBO Designer is to provide the applications
  211.        programmer with an "easy-to-use" interface, so the programmer can
  212.        concentrate on producing a highly functional program without
  213.        worrying about the trivialities of the user interface.
  214.  
  215.         TURBO Designer is capable of editing and generating: vertical
  216.        and horizontal pop up menus, pull down menus, context-sensitive
  217.        status lines, context-sensitive interactive pop-up help screens.
  218.        Furthermore, TURBO Designer allows complete customization of
  219.        screen colors and the environment's appearance.
  220.  
  221.         The environment which TURBO Designer operates in is the same
  222.        user-friendly environment that it generates, so that users of
  223.        TURBO Designer can experience the environment while also
  224.        providing an example of an application using this environment.
  225.  
  226.         Specifically, TURBO Designer's windowing environment consists of
  227.        three precompiled units: TD1VARS, TD1VIDEO, TD1UTILS. Two sets of
  228.        these units appear on the distribution disks; one is for TURBO
  229.        Pascal version 4.0, the other is for TURBO Pascal version 5.0
  230.        (Borland should be reprimanded for making the .TPU file formats
  231.        NOT upwardly compatible). Be sure to use the right set.
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                              Page 4
  241.         WHAT'S IN A MENU?
  242.         In order to establish a corresponding terminology between the
  243.        author and the reader, common vocabulary is introduced in the
  244.        following paragraphs.
  245.  
  246.        PULL DOWN MENUS
  247.  
  248.        A PULL DOWN menu is a menuing system where a horizontal MENU BAR
  249.        (usually located on the top of the screen) presents the MENU
  250.        HEADERS. When the pull down menu system is activated, one menu
  251.        header on the menu bar is highlit. The user sequentially "moves"
  252.        through the menu headers by pressing the arrow keys to move the
  253.        SELECTION BAR in the direction indicated on the arrow key. When
  254.        the user arrives on the topic of choice, the user selects the
  255.        menu header by pressing enter, and a SUB MENU appears. An
  256.        alternate route is for the user to type the HOT KEY associated
  257.        with the menu header of choice. A menu bar is comprised of a
  258.        group of menu headers, each menu header has in it exactly one
  259.        letter which is both highlit and unique to the set of highlit
  260.        letters on the menu bar. This letter which is highlit is a HOT
  261.        KEY. While the pull down system is active and the sub menus are
  262.        not activated, pressing a key on the keyboard which corresponds
  263.        to a hot key on the menu bar will (1) move the selection bar to
  264.        the corresponding menu header if needed, and (2) activate the SUB
  265.        MENUS. A SUB MENU is a box which pops up under the corresponding
  266.        menu header. A sub menu box displays 0 through 22 SELECTIONS.
  267.        Each selection is similar to a menu header in that it may contain
  268.        a hot key, and this hot key is operated on in the same fashion as
  269.        described with menu header hot keys above. Each selection can be
  270.        dissimilar in one of two following ways: (1) the selection is
  271.        DEAD, displayed in a neutral color, and denies access to both hot
  272.        keys and the selection bar; or (2) the selection is defined as a
  273.        PARTITION,  displayed as a vertical bar composed of multiple
  274.        copies a single character across the width of the sub menu, and
  275.        denies access to both hot keys and the selection bar. ENTRY is a
  276.        term synonymous to SELECTION. Selecting an entry causes an action
  277.        associated with that entry's label to occur.
  278.  
  279.         ESC is the complement to Enter. Pressing ESC will cause the
  280.        system to jump back one step. If, while the sub menus are active,
  281.        the user presses ESC, the sub menus will deactivate, and the user
  282.        will be prompted to select a menu header from the menu bar. There
  283.        is a case where this is not true: when a sub menu contains 0
  284.        entries, pressing ESC will deactivate the entire pull down menu
  285.        system. If, when the sub menus are deactivated, the user presses
  286.        ESC, the entire pull down system will deactivate, and the flow of
  287.        control will return to the main program.
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                              Page 5
  301.        HORIZONTAL POP UP MENUS
  302.  
  303.         A HORIZONTAL POP UP menu is a pop up menu with a PROMPT. The
  304.        prompt is usually a statement or a question. Under the prompt,
  305.        there are between 1 and 10, inclusive, ENTRIES (or SELECTIONS).
  306.        The entries are set up in a grid-like formation. Horizontal pop
  307.        up menus currently do not support hot keys. The only method for
  308.        selecting an entry is by the arrow keys. To move the selection
  309.        bar, the user moves the arrow key associated with the direction
  310.        he/she wishes to travel. Selecting an entry is accomplished
  311.        through the ENTER key. Abandoning the horizontal pop up menu and
  312.        returning to the application program is accomplished through the
  313.        ESC key.
  314.  
  315.  
  316.        VERTICAL POP UP MENUS
  317.  
  318.         A VERTICAL POP UP MENU is a "normal" pop up menu. The menu
  319.        contains between 1 and 22, inclusive, entries. The user may
  320.        select an entry by using the arrow keys and ENTER, or, as a short
  321.        cut, the user may elect to use hot keys instead. The method for
  322.        selection is identical to that of SUB MENUS (described on the
  323.        previous page).
  324.  
  325.         When a menu is referred to as a "pop up menu", without
  326.        indication of its alignment, the reader may correctly assume that
  327.        a VERTICAL POP UP MENU is being referenced.
  328.  
  329.  
  330.        POP UP HELP SCREENS
  331.  
  332.         A POP UP HELP SCREEN is a window, when activated, appears on the
  333.        screen with the help text written upon it. On the bottom of the
  334.        help screens, there may or may not be SELECTIONS. When there are
  335.        selections, the user uses the arrow keys to sequentially move the
  336.        SELECTION BAR around the list of selections. If the user presses
  337.        ENTER, the selection that is highlit by the selection bar will be
  338.        processed, and another help menu described by that selection will
  339.        appear. If the user presses F1 in a help screen, a HELP INDEX, if
  340.        there is one, will appear. A HELP INDEX is a normal help screen
  341.        which will usually contain access to most or all of the other
  342.        help screens. Some help screens are independent of the rest of
  343.        the help system, and have no selections. The user may escape the
  344.        help system and return to the program at any time by pressing
  345.        ESC.
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                              Page 6
  361.          POP UP DIRECTORY
  362.  
  363.         A POP UP DIRECTORY is a window, when activated, shows a
  364.        directory listing inside the window. First, the user enters a
  365.        MASK definition. The directory will pop up with listing of all
  366.        files in that mask. The mask is same type of mask that DOS uses,
  367.        so that mask may, and usually will, contain wildcard characters
  368.        (* and ?). See the DOS manual for further reference on masks. If
  369.        there are no files that match with the mask definition, an error
  370.        message will be displayed, and the directory listing subroutine
  371.        will be terminated. When there are file names that match with the
  372.        mask, the will be displayed in a grid-like format, and the top
  373.        left entry will be selected. The user may move the selection bar
  374.        through the grid horizontally or vertically using all four arrow
  375.        keys. The selection bar will "wrap around" to the other side if
  376.        the user tries to move it beyond the defined boundaries. If the
  377.        entry begins with a back slash character (\), that entry is
  378.        actually a name of a sub-directory. If the selection bar is on a
  379.        sub-directory, and the user presses ENTER, the mask will
  380.        concatenate the current directory path with the new path, and
  381.        display a new listing. If the sub-directory name is \.. then the
  382.        parent directory is displayed. See the DOS reference book for
  383.        complete definitions of the terms defined above. If the mask
  384.        matches more than 112 file names, only the first 112 file names
  385.        will be displayed on the screen. If the user attempts to access
  386.        the file names below the bottom of the displayed names, the
  387.        selection bar will disappear, but will be logically where it is
  388.        supposed to be. The selection bar will reappear the it "wraps
  389.        around", or the user move the selection bar back up onto the
  390.        visible portion of the screen. The user may escape from the
  391.        directory listing at any time by pressing ESC.
  392.  
  393.          TRASH CAN
  394.         The TRASH CAN is a process of deleting files which offers a
  395.        method which is more sophisticated than the DOS DELETE (or ERASE)
  396.        command. The trash can comes as a three step process. The first
  397.        step is when the user puts a file name in the trash can. The
  398.        second step is when the user may examine the trash can, and remove
  399.        accidentally thrown-out file names. The third step is when the
  400.        trash can is emptied, and the file names are deleted from the
  401.        disk.
  402.  
  403.        In the first step, the user will be prompted for a file mask, and
  404.        a directory listing will be displayed. The user operates the
  405.        directory listing in the exact method described above in "POP UP
  406.        DIRECTORY", with one exception : any file name selected with the
  407.        ENTER key will cause an action to take place. If the file name is
  408.        a sub-directory, a new directory listing will appear. If the file
  409.        name is an actual file, the file name will be put in the trash
  410.        can list. A file name in the trash can list still exists in
  411.        actuality, and will show up in any directory listing. To throw
  412.        out more than one file name at a time, a TRASH GROUP facility was
  413.        established. The TRASH GROUP facility prompts the user for a mask
  414.        definition, and will put all file names which match the mask in
  415.        the trash can.
  416.  
  417.  
  418.  
  419.  
  420.                              Page 7
  421.         In the second step, the user may look at the contents of the
  422.        trash can. The contents are displayed in a list. The user may
  423.        move up and down the list with the appropriate arrow keys. The
  424.        list on the screen will scroll if the user moves the selection
  425.        bar outside the set boundaries. If the user presses ENTER, the
  426.        file name which is under the selection bar will be removed from
  427.        the trash can. If the user presses ESC, the trash can is
  428.        deselected, and the program returns to normal execution.
  429.  
  430.         In the third step, the files are removed both from the trash can
  431.        and from the disk. The user receives a chance to abandon this
  432.        operation when it is selected (similar to DOS's Are you sure
  433.        (y/n)? message). If the user proceeds, the files are deleted, and
  434.        the trash can list is left empty. If there any disk errors during
  435.        this process, the file name is removed from the trash can,
  436.        however it may not necessarily be removed from the disk.
  437.  
  438.         There is an icon at the bottom right of the screen with a
  439.        picture of a trash can in it, with the caption "TRASH."
  440.  
  441.        ACCESS SYSTEM CLOCK
  442.  
  443.          In this option, a vertical pop up menu appears which has two
  444.        entries in it. The first entry shows the current date. The second
  445.        entry shows the current time, and is continually updated. If the
  446.        user selects either of these entries, another window appears
  447.        prompting the user to change the time or date. If the user makes
  448.        any changes, the system time and/or date changes also. At the
  449.        bottom left corner of the screen there is an icon which has a
  450.        picture of a clock, and has the caption "Access system clock."
  451.  
  452.         TURBO DESIGNER'S PULL DOWN MENU SYSTEM
  453.  
  454.         This section will describe the pull down menu system inside TD1.
  455.  
  456.        The first menu header is drawn as a tiny box on the menu bar.
  457.        It's hot-key is "A". It has two entries in it's sub-menu.
  458.  
  459.         CONTROL PANEL
  460.          Selecting this entry will cause a pop up window to appear.
  461.        Inside this window is a lot of technical information. Press ENTER
  462.        to leave.
  463.  
  464.         ABOUT TURBO DESIGNER
  465.          Selecting this entry will cause a pop up window to appear.
  466.        Inside this window there is compiler release information. Press
  467.        ENTER to leave.
  468.  
  469.        The second menu header is the "File" sub-menu. It's hot-key is
  470.        "F".
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.                              Page 8
  481.         LOAD WORK FILE
  482.          Selecting this entry will load a previously edited file into
  483.        TURBO DESIGNER. First, you will be asked if you want to save the
  484.        current work file. The responses are "Yes", "No", and "Cancel".
  485.        If you wish to abandon the LOAD WORK FILE option, this is your
  486.        last chance; select "Cancel" to return to the pull down system.
  487.        If you choose "Yes" or "No", the appropriate save action will
  488.        take place. You will then be prompted for a load file name in the
  489.        same fashion as described previously in "POP UP DIRECTORY". After
  490.        you select a file name, the file will be loaded. If you press ESC
  491.        in the directory listing, the current file will be erased from
  492.        memory and the file name will be set back to "NONAME".
  493.  
  494.         CREATE WORK FILE
  495.          Selecting this entry will set up a new work file. First, you
  496.        will be asked if you want to save the current work file The
  497.        responses are "Yes", "No", and "Cancel" If you wish to abandon
  498.        the CREATE WORK FILE option, this is your last chance; select
  499.        "Cancel" to return to the pull down system. If you choose "Yes"
  500.        or "No", the appropriate save action will take place. You will
  501.        then be prompted for a new work file name. This work file name
  502.        may be up to eight characters in length, and may be anything that
  503.        is legal in DOS, with the following two exceptions: the filename
  504.        may not end with "UNT1" or "UNT2", or the code generated for your
  505.        program will be incomplete. All the files that will be necessary
  506.        will be created at this time.
  507.  
  508.         SAVE WORK FILE
  509.          Selecting this entry will unconditionally save the current work
  510.        file. Make sure there is enough space on the disk you are working
  511.        with to save the work file.
  512.  
  513.         RENAME WORK FILE
  514.          Selecting this entry will allow you to rename your work file.
  515.        You will first be prompted for a new work file name. This new
  516.        work file name may be up to eight characters in length, and may
  517.        be anything that is legal in DOS, with the following two
  518.        exceptions: the filename may not end with "UNT1" or "UNT2", or
  519.        the code generated for your program will be incomplete. This
  520.        entry uses the RENAME function from DOS.
  521.  
  522.         SHOW DIRECTORY
  523.          Selecting this entry will cause a pop up directory to appear.
  524.        For more information see "POP UP DIRECTORY" on page 7.
  525.  
  526.         CHANGE DIRECTORY
  527.          Selecting this entry will cause a pop up edit window to appear.
  528.        Type in the new directory name. Press ENTER when the new name is
  529.        typed in. This will use DOS's CHDIR command, and will report any
  530.        errors that DOS returns.
  531.  
  532.         TRASH FILE NAME
  533.          Selecting this entry will cause the first step of the process
  534.        described previously in the "TRASH CAN" section to take place.
  535.        For more information, see "TRASH CAN".
  536.  
  537.  
  538.  
  539.  
  540.                              Page 9
  541.         TRASH GROUP
  542.          Selecting this entry will cause the "TRASH GROUP" process
  543.        described previously in the "TRASH CAN" section to take place.
  544.        For more information, see "TRASH CAN".
  545.  
  546.         QUIT
  547.          Selecting this entry will end TD1, and return to DOS. Before
  548.        leaving, however, you will be asked if you want to save the
  549.        current work file. The responses are "Yes", "No", and "Cancel".
  550.        If you wish to abandon the QUIT option, this is your last chance;
  551.        select "Cancel" to return to the pull down system. If you choose
  552.        "Yes" or "No", the appropriate save action will take place. TD1
  553.        will then halt, and return to DOS.
  554.  
  555.        The third menu header is "Edit". It's hot key is "E". Selecting
  556.        edit will return you to editing your work file. "Edit" has no
  557.        sub-menus.
  558.  
  559.        The fourth menu header is "View". It's hot key is "V".
  560.  
  561.         VIEW CLOCK
  562.          Selecting this entry will cause the access clock function to
  563.        activate. For more information, see ACCESS SYSTEM CLOCK.
  564.  
  565.         VIEW TRASH CAN
  566.           Selecting this entry will cause the second step of the process
  567.        described previously in the "TRASH CAN" section to take place.
  568.        For more information, see "TRASH CAN".
  569.        The fifth menu header is "Special". It's hot key is "S".
  570.  
  571.         RESHADOW
  572.          Selecting this entry will cause TD1's pull down system to
  573.        toggle the pull down shadow. Select this a few times to see what
  574.        it does. To call this in your generated program call Procedure
  575.        ReShadow;.
  576.  
  577.         EMPTY TRASH CAN
  578.           Selecting this entry will cause the third step of the process
  579.        described previously in the "TRASH CAN" section to take place.
  580.        For more information, see "TRASH CAN". Since files will be
  581.        erased, be careful with this selection.
  582.  
  583.         TOGGLE PRINT SCREEN
  584.           Selecting this entry will toggle the ability to use print
  585.        screen on and off. This entry uses Procedure SetPrtSc(Switch :
  586.        Boolean); from TD1VARS. To set Print screen on use:
  587.        SetPrtSc(TRUE); To Turn print screen off use: SetPrtSc(FALSE);.
  588.  
  589.         SELECT ME!
  590.         CHOOSE ME!
  591.          These entries demonstrate the use of "dead" entries. Selecting
  592.        one of these will "kill" the entry, and "revive" the other. The
  593.        procedures used are Procedure KillEntry(X,Y : Byte); and
  594.        Procedure ReviveEntry(X,Y : Byte); from TD1VIDEO. X is the
  595.        coordinate of the sub-menu in the pulldown system. Y is the
  596.        coordinate of the entry in that sub-menu. (In calculating the Y
  597.        coordinate, partitions should be included). You can also use on
  598.        page 4 of designing pull down menus. See DESIGNING PULL DOWN
  599.        MENUS.
  600.                              Page 10
  601.        The sixth menu header is "Generate". It's hot key is "G".
  602.  
  603.        GENERATE TURBO PASCAL CODE
  604.         This entry, when selected, generates the TURBO Pascal code
  605.        defined by your work file. Once the code has been generated,
  606.        press a key to return to the pull down system.
  607.  
  608.  
  609.        GETTING STARTED
  610.  
  611.        INSTALLING TD1
  612.                     DO NOT INSTALL TD1 ON THE ORIGINAL DISK!
  613.         Copy all files onto an empty, formatted disk or an empty
  614.        directory. If you want to use TURBO Pascal version 4.0, run
  615.        TP4Inst.Bat by typing TP4Inst at the DOS prompt. If you want to
  616.        use TP5Inst.Bat by typing TP5Inst at the DOS prompt.
  617.  
  618.        LOADING TD1
  619.          Load TD1 at the DOS prompt by typing "TD1" (without the
  620.        quotes). Make sure TD1.EXE, TD1.HLI, TD1.HTE, TD1.HIN are in the
  621.        current directory and drive.
  622.  
  623.          If your monitor is a black and white (or black and green, or
  624.        black and amber, etc.) type "TD1 -m" (without the quotes).
  625.  
  626.          Once TD1 is loaded, read the registration screen, and press
  627.        ENTER when you are done. You may then proceed to edit your
  628.        system. If you need help right away, press ENTER or F1. You would
  629.        most likely need to use the pull down menus to load or create a
  630.        file. Press F10 to activate the pull down menus. Then press "F"
  631.        to activate the "File" sub-menu. Using the arrow keys if needed,
  632.        select either "Load"
  633.        or "Create" options, and you will be on your way. For a sample
  634.        session see "A SAMPLE SESSION" on page 18.
  635.  
  636.          You should design a few test files before actually doing
  637.        serious work, to insure your familiarity with the environment.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.                              Page 11
  661.        DESIGNING PULL DOWN MENUS
  662.  
  663.         Page 1
  664.                In this page, the menu bar is designed. The text is
  665.        entered as it would be with a word processor. At the top of the
  666.        screen, a count of how many menu headers on the line being edited
  667.        is displayed. If you should want help, press F1. If you want to
  668.        go back to the "Design menus" icon-menu, press PgUp. When you
  669.        want to proceed to page 2, press PgDn. A syntax error check will
  670.        take place. The menu bar will be checked with the following
  671.        criteria: between 1 and 15 menu headers exist, each menu header
  672.        has a UNIQUE hot key, and each menu header has a hot key.
  673.  
  674.         Page 2
  675.               In this page, the entries in the sub-menu are defined.
  676.        Move the selection bar to the selection you wish to enter. Press
  677.        the backspace key, and the selection bar will turn into a cursor.
  678.        Type in the entry name using the same method described for
  679.        entering the menu bar from page 1. Do not use the underscore as
  680.        the first character in the entry name. Pressing ENTER will cause
  681.        the selection bar to reappear. Move the selection bar to edit
  682.        more entries. Use the help menus on the side and bottom as a
  683.        guide. Press PgUp to go back to page 1. Press PgDn to go to page
  684.        3. Another syntax check will take place. The syntax check will
  685.        check: A blank line in between two non-blank entries, each menu
  686.        has a UNIQUE hot key, and each non-blank entry has a hot key.
  687.  
  688.         Page 3
  689.              In this page, the context-sensitive help lines are entered
  690.        for the pull down system. To enter a help line for an ENTRY, move
  691.        the selection bar to the entry you want to enter help into.
  692.        Pressing ENTER will cause a pop up edit window to appear. Type in
  693.        the text of the help line in the same fashion as entering the
  694.        menu bar, and press ENTER to return to the pull down system. To
  695.        enter To enter a help line for a MENU HEADER, move the selection
  696.        bar to the sub-menu you want to enter help into. Pressing F5 will
  697.        cause a pop up edit window to appear. Type in the text of the
  698.        help line in the same fashion as entering the menu bar, and press
  699.        ENTER to return to the pull down system. If you want to change
  700.        the status of the pull down shadow, pressing F2 will toggle the
  701.        shadow on and off. Pressing PgUp will go back to page 2. Pressing
  702.        PgDn will go to Page 4. No syntax error checks take place.
  703.  
  704.         Page 4
  705.              This page allows you to "kill" entries, if you need to, so
  706.        that the generated program will start off with "dead" entries.
  707.        "Dead" entries are entries which are displayed in a neutral
  708.        color, and cannot be accessed. In the "Special" menu in TD1,
  709.        there is an example of a dead entry. For more information see
  710.        page 10. To "kill" an entry, move the selection bar to the entry
  711.        you wish to "kill," and press F5. If nothing happens, press F2,
  712.        then F5 again. Pressing F2 toggles the "Kill mode" between "Kill"
  713.        and "Revive." To "Revive" an entry, put the system in "Revive"
  714.        mode, if you need to, move the selection bar to the "dead" entry
  715.        you wish to revive, and press F5. If you want to know which mode
  716.        you are in, just look on the help screen displayed at the "F5"
  717.        section, and it will tell you what state the system is in. If you
  718.        need more help than is provided, press F1. To go to page 3, press
  719.  
  720.                              Page 12
  721.  
  722.        PgUp. To go on, press PgDn. This will take you back to the
  723.        "Design Menus" icon, and also save the pull downs as you have
  724.        defined them. The help definitions you entered in page 3 will be
  725.        shown at the bottom of the screen.
  726.        Due a persistent bug, the bottom line may not be correct. Do not
  727.        worry, the generated code does not have this problem.
  728.  
  729.        The process may be repeated many times if need to go back, and
  730.        change some aspect.
  731.  
  732.        NOTE: If you go back and edit the menu bar, and the number of
  733.        menu headers change, the entry definitions that were in the
  734.        previous set of pull down menus will NOT change, and will be
  735.        inaccurate.
  736.  
  737.  
  738.        DESIGNING HORIZONTAL POP UP MENUS
  739.  
  740.        Page 1
  741.             This page may come in two forms, depending on whether or not
  742.        you already have previously defined horizontal pop up menus.
  743.        [Form 1:] If there are no horizontal pop up menus to enter, a pop
  744.        up edit box will appear. If you wish to leave, press ENTER
  745.        without typing anything, otherwise, type in the name of the
  746.        "KEY". The "KEY" is TD1's method of organizing the menus. Please
  747.        do not use any characters other than "A"..."Z", and "0".."9". It
  748.        will make it easier to use the generated menus. Press ENTER when
  749.        you have typed in the key name. [Form 2:] If there are previous
  750.        horizontal pop up menus loaded, a list of the key names will
  751.        appear. Among these names is "<NEW MENU NAME>". Move the up and
  752.        down arrow keys to move the selection bar. Press ENTER to select
  753.        an entry name. If you select "<NEW MENU NAME>", you will embark
  754.        on the process described in [Form 1:].
  755.  
  756.        Page 2
  757.            On this page you will be prompted for a prompt to your pop up
  758.        menu. A pop up edit window will appear. Edit the prompt as you
  759.        would edit a document in a word processor. Press ENTER when you
  760.        are done.
  761.  
  762.        Page 3
  763.            On this page you select the colors you wish to use in the pop
  764.        up menu. To select the colors, use the up and down arrow keys to
  765.        select which set of colors to change: Normal, Highlighted, or
  766.        Inverse. Press ENTER. A color change screen will appear. To
  767.        change the background color, use the left and right arrow keys to
  768.        move through the list of background colors. To change the
  769.        foreground color, use the up and down arrow keys to move through
  770.        the list of foreground colors. Press ENTER when you decide on the
  771.        color to use.
  772.        To go to page 4, press PgDn.
  773.  
  774.        Page 4
  775.             On page 4, you can reconfigure the border style that your
  776.        pop up menu uses. Use the arrow keys to move the selection bar,
  777.        and the ENTER key to change the character associated with that
  778.        selection.
  779.        Press F1 if you need help. Press PgDn to go to page 5.
  780.                              Page 13
  781.        Page 5
  782.             Page 5 lets you enter the entries to be used in the pop up
  783.        menu. Up to 10 entries may be defined. To edit an entry, move the
  784.        selection bar to the entry you wish to edit and press BACKSPACE.
  785.        Then, type in that entry using the keys you would use in a word
  786.        processor. Press ENTER to bring the selection bar back. Press
  787.        PgDn to go to page 6. Before proceeding to page 6, a syntax error
  788.        check takes place. The syntax error check checks for a blank line
  789.        between two non-blank entries. Hot keys are not implemented for
  790.        horizontal pop up menus.
  791.  
  792.        Page 6
  793.             Page 6 is a pop up menu which asks you whether or not you
  794.        want a shadow with your pop up menu. Type in "Y" or "N" to go to
  795.        page 7. The "Cancel" operation is not defined for this window.
  796.  
  797.        Page 7
  798.             With page 7, you can set the coordinates for the pop up
  799.        menu. The pop up menu you have just specified will appear on the
  800.        screen,
  801.        none of the selections will be highlit. Move this menu around
  802.        using then arrow keys. When you have placed it on a spot which
  803.        you like, press PgDn to exit editing the pop up menus.
  804.  
  805.         You will then return to the "Design menus" icon menu. The pop up
  806.        menu you just designed will be saved.
  807.  
  808.        DESIGNING VERTICAL POP UP MENUS
  809.  
  810.        Page 1
  811.             This page may come in two forms, depending on whether or not
  812.        you already have previously defined vertical pop up menus. [Form
  813.        1:] If there are no vertical pop up menus to enter, a pop up edit
  814.        box will appear. If you wish to leave, press ENTER without typing
  815.        anything, otherwise, type in the name of the "KEY". The "KEY" is
  816.        TD1's method of organizing the menus. Please do not use any
  817.        characters other than "A"..."Z", and "0".."9". It will make it
  818.        easier to use the generated menus. Press ENTER when you have
  819.        typed in the key name. [Form 2:] If there are previous vertical
  820.        pop up menus loaded, a list of the key names will appear. Among
  821.        these names is "<NEW MENU NAME>". Move the up and down arrow keys
  822.        to move the selection bar. Press ENTER to select an entry name.
  823.        If you select "<NEW MENU NAME>", you will embark on the process
  824.        described in [Form 1:].
  825.        Page 2
  826.             On this page you select the colors you wish to use in the
  827.        pop up menu. To select the colors, use the up and down arrow keys
  828.        to select which set of colors to change: Normal, Highlighted, or
  829.        Inverse. Press ENTER. A color change screen will appear. To
  830.        change the background color, use the left and right arrow keys to
  831.        move through the list of background colors. To change the
  832.        foreground color, use the up and down arrow keys to move through
  833.        the list of foreground colors. Press ENTER when you decide on the
  834.        color to use. To go to page 3, press PgDn.
  835.  
  836.  
  837.  
  838.  
  839.  
  840.                              Page 14
  841.        Page 3
  842.             On page 3, you can reconfigure the border style that your
  843.        pop up menu uses. Use the arrow keys to move the selection bar,
  844.        and the ENTER key to change the character associated with that
  845.        selection.
  846.        Press F1 if you need help. Press PgDn to go to page 4.
  847.  
  848.        Page 4
  849.             Page 4 lets you enter the entries to be used in the pop up
  850.        menu. Up to 10 entries may be defined. To edit an entry, move the
  851.        selection bar to the entry you wish to edit and press BACKSPACE.
  852.        Then, type in that entry using the keys you would use in a word
  853.        processor. Press ENTER to bring the selection bar back. Press
  854.        PgDn to go to page 5. Before proceeding to page 5, a syntax error
  855.        check takes place. The syntax error check checks for a blank line
  856.        between two non-blank entries, and makes sure that each entry has
  857.        a UNIQUE hot key, and each entry has a hot key.
  858.  
  859.        Page 5
  860.             Page 5 is a pop up menu which asks you whether or not you
  861.        want a shadow with your pop up menu. Type in "Y" or "N" to go to
  862.        page 6. The "Cancel" operation is not defined for this window.
  863.  
  864.        Page 6
  865.             With page 6, you can set the coordinates for the pop up
  866.        menu. The pop up menu you have just specified will appear on the
  867.        screen,
  868.        none of the selections will be highlit. Move this menu around
  869.        using then arrow keys. When you have placed it on a spot which
  870.        you like, press PgDn to exit editing the pop up menus.
  871.  
  872.         You will then return to the "Design menus" icon menu. The pop up
  873.        menu you just designed will be saved.
  874.  
  875.        COLOR CONSTANTS AND YOUR PROGRAMS ENVIRONMENT
  876.  
  877.         SETTING YOUR PROGRAM'S COLORS
  878.  
  879.             On this icon menu, you select the default colors you wish to
  880.        use in your program. There are four sets of colors used in the
  881.        program: Background colors, Standard colors, Directory colors,
  882.        Icon colors. In order to change the colors, use the arrow keys to
  883.        move the selection box to the set of colors you want to change,
  884.        then press ENTER. To change the set of colors, use the up and
  885.        down arrow keys to select which type of colors to change: (where
  886.        appropriate) Normal, Highlighted, Inverse, or Dead. Press ENTER.
  887.        A color change screen will appear. To change the background
  888.        color, use the left and right arrow keys to move through the list
  889.        of background colors. To change the foreground color, use the up
  890.        and down arrow keys to move through the list of foreground
  891.        colors. Press ENTER when you decide on the color to use. Press
  892.        PgDn to go back to the icon menu. Press ESC to leave the icon
  893.        menu.
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.                              Page  15
  901.        SETTING YOUR PROGRAMS ENVIRONMENT
  902.  
  903.        Page 1
  904.             This page lets you define your program's BACKGROUND
  905.        CHARACTER. The background character is used in the beginning of
  906.        your program to make a background. In this screen, you may either
  907.        choose "Select" to choose another BACKGROUND CHARACTER, or "Use
  908.        Default" to keep the current BACKGROUND CHARACTER, or "Cancel" to
  909.        return to the previous icon menu. If you choose "Select", a
  910.        selection screen appears, and you choose a new BACKGROUND
  911.        CHARACTER by moving the arrow keys to make the cursor point to
  912.        the character you want and press ENTER. Another screen will
  913.        appear with the background drawn. If you like it, press ENTER;
  914.        otherwise press ESC.
  915.  
  916.        Page 2
  917.             This page lets you edit the PERMANENT STATUS BAR. Just type
  918.        in the status bar as you would with a word processor. If you need
  919.        more help than is provided, press F1. To return to page 1, press
  920.        PgUp. To go on to page 3, press PgDn.
  921.  
  922.        Page 3
  923.             On page 3, you can reconfigure the border style that your
  924.        pull down menu uses. Use the arrow keys to move the selection
  925.        bar, and the ENTER key to change the character associated with
  926.        that selection. Press PgUp to go to page 2. Press PgDn to
  927.        go back to the icon menu.
  928.  
  929.        HELP SCREEN DEFINITIONS
  930.  
  931.        EDIT HELP SCREEN DEFINITION
  932.  
  933.        Page 1
  934.             This page may come in two forms, depending on whether or not
  935.        you already have previously defined help screens. [Form 1:] If
  936.        there are no help screens to enter, a pop up edit box will
  937.        appear. If you wish to leave, press ENTER without typing
  938.        anything, otherwise, type in the name of the "KEY". The "KEY" is
  939.        TD1's method of organizing the menus. Please do not use any
  940.        characters other than "A"..."Z", and "0".."9". Press ENTER when
  941.        you have typed in the key name. [Form 2:] If there are previous
  942.        help screens defined, a list of the key names will appear. Among
  943.        these names is "<Enter new name>". Move the up and down arrow
  944.        keys to move the selection bar. Press ENTER to select an entry
  945.        name. If you select "<Enter new name>", you will embark on the
  946.        process described in [Form 1:].
  947.  
  948.        Note: Naming your help screen key as Help_Index makes that
  949.        definition the help index. In your generated program, pressing F1
  950.        after loading a help screen will load the help index.
  951.  
  952.        Page 2
  953.            On this page you will be prompted for a title to your help
  954.        menu. A pop up edit window will appear. Edit the title as you
  955.        would edit a document in a word processor. Press ENTER when you
  956.        are done.
  957.  
  958.  
  959.  
  960.                              Page 16
  961.        Page 3
  962.             With this page, you define the coordinates of the help
  963.        screen you wish to design. You first use the arrow keys to move
  964.        the top left corner to the coordinate you wish to use. Press
  965.        ENTER when you reach that coordinate. You then will move the
  966.        bottom right corner to the coordinate you wish to use. Press
  967.        ENTER when you reach the coordinates you want. Then, either press
  968.        ENTER to accept this definition and go on to page 4, or ESC to
  969.        redo the definition. Press F1 at any point to receive help.
  970.  
  971.        Note: A short cut to moving the cursor around: Holding the SHIFT
  972.        KEY down while moving the arrow keys on the NUMERIC KEYPAD causes
  973.        the cursor to jump 5 units in each direction.
  974.  
  975.        Page 4
  976.             On this page you select the colors you wish to use in the
  977.        help screen. To select the colors, use the up and down arrow keys
  978.        to select which set of colors to change: Normal, Highlighted, or
  979.        Inverse. Press ENTER. A color change screen will appear. To
  980.        change the background color, use the left and right arrow keys to
  981.        move through the list of background colors. To change the
  982.        foreground color, use the up and down arrow keys to move through
  983.        the list of foreground colors. Press ENTER when you decide on the
  984.        color to use. To go to page 5, press PgDn.
  985.  
  986.        Page 5
  987.             On page 5, you can configure the border style that help
  988.        screen uses. Your choices are either SINGLE or DOUBLE border.
  989.        Press ENTER to go to page 6.
  990.  
  991.        Page 6
  992.             Page 6 is a pop up menu which asks you whether or not you
  993.        want a shadow with your pop up menu. Type in "Y" or "N" to go to
  994.        page 7. The "Cancel" operation is not defined for this window.
  995.  
  996.        Page 7
  997.             The help definition you defined is displayed on the screen.
  998.        If you are satisfied with it, press ENTER; otherwise press ESC to
  999.        go to page 2.
  1000.        EDIT HELP SCREEN TEXT
  1001.  
  1002.        Page 1
  1003.              If there are previous help screens defined, a list of the
  1004.        key names will appear. Move the up and down arrow keys to move
  1005.        the selection bar. Press ENTER to select an entry name.
  1006.  
  1007.        Page 2
  1008.             A help window with the definition described by the help
  1009.        screen definition you selected in page 1. This screen is a full
  1010.        screen editor. Use the arrow keys to move the cursor around.
  1011.        Press ENTER to go to the next line. Pressing BACKSPACE will move
  1012.        the cursor back one character, and it is non-destructive. Type in
  1013.        the text of the help screen like you would with a word processor.
  1014.        This editor is permanently stuck in TYPEOVER (or OVERWRITE) mode,
  1015.        meaning that if you are typing along a line, the words to the
  1016.        right of the cursor are not moved. Pressing the insert key will
  1017.        insert a space at the current cursor position. Pressing delete
  1018.        will delete a character at the current cursor position.
  1019.  
  1020.                              Page 17
  1021.        Pressing F1 will call up a help screen.
  1022.        Pressing F8 will abort this help screen, and return to the last
  1023.        icon menu.
  1024.        Pressing the END key will save this screen, and return to the
  1025.        last icon menu.
  1026.  
  1027.        Pressing the F3 key will toggle the link mode on and off.
  1028.        To use the link mode, move the cursor to the position you want to
  1029.        start to link at. Press F3. You will be able to move the cursor
  1030.        to the right only (and left, just as long as you don't move
  1031.        beyond the start of the link). Move the cursor right until you
  1032.        reach the ending position. Press F3 again. A pop up menu with all
  1033.        the help screens will appear. Choose one of these. The area you
  1034.        defined as the link area will now be displayed in the INVERSE
  1035.        color of that help screen. You may move the cursor through the
  1036.        link area but you cannot type anything in it. If your cursor is
  1037.        on a link area and you press ENTER, the help screen you are
  1038.        working on will be saved, and the help screen that is linked to
  1039.        the link area will be loaded and edited.
  1040.  
  1041.        NOTE: AFTER STARTED OR FINISHING A LINK, THE CHANGE IS
  1042.        *PERMANENT* PLEASE SIT DOWN AND MAP OUT YOUR HELP SCREENS ON
  1043.        PAPER BEFORE USING TD1.
  1044.  
  1045.        A SAMPLE SESSION
  1046.  
  1047.          Now that TD1 is installed on your system, load TD1 using the
  1048.        method described in GETTING STARTED.
  1049.  
  1050.        Press ENTER after reading the registration screen.
  1051.  
  1052.        Press F10 to activate the pulldown menus.
  1053.  
  1054.        Press "F" to activate the "File" sub-menu.
  1055.  
  1056.        Press "W" to select the "create Work file" entry.
  1057.  
  1058.        Press "N" to tell the system "NO! I don't want to save NONAME!"
  1059.  
  1060.        Type "TEST1" when you are prompted for a file name.
  1061.  
  1062.        Press ESC to deactivate the "File" sub-menu.
  1063.  
  1064.        Press "E" to select "Edit" sub-menu.
  1065.  
  1066.        Press the left arrow key once, so that the ICON-menu cursor lies
  1067.        on the "Design menus" option.
  1068.  
  1069.        Press ENTER to select the ICON. Another set of icons will appear.
  1070.  
  1071.        Press the left arrow key once, so that the ICON-menu cursor lies
  1072.        on the "Pull down menus" option.
  1073.  
  1074.        Press ENTER to select the ICON. A line editor will appear.
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.                              Page 18
  1081.        On the line, type these four words, "This Is A tEst", keeping the
  1082.        letters that are capitalized, capitalized. You may put as many
  1083.        spaces between the words as you wish. Press F1 if you need any
  1084.        help. Notice at the top of the window, the "Number of headers" is
  1085.        equal to 4.
  1086.  
  1087.        Before you press ENTER, use the arrow keys to edit the line so
  1088.        that it reads "This Is Some how A tEst", with only one space
  1089.        between "Some" and "how". Notice that the "Number of headers" is
  1090.        equal to 6.
  1091.  
  1092.        Move the arrow keys between "Some" and "how" and press the Delete
  1093.        key on your keyboard. The line should read "This Is Somehow A
  1094.        tEst"
  1095.        The "Number of headers" is equal to 5.
  1096.  
  1097.        Without moving the cursor, press the F3 key. A "Hard space" was
  1098.        added between "Some" and "how", so the line reads
  1099.        "This Is Some how A tEst" and the "Number of headers" is equal to
  1100.        5.
  1101.  
  1102.  
  1103.        Press the F2 key. Notice the hard space has become a flashing *.
  1104.        Press ESC to leave that mode.
  1105.  
  1106.        Move the cursor to the "S" in "Some how" and press the delete key
  1107.        until "Some how" no longer exists.
  1108.  
  1109.        Now press ENTER to go to page 2.
  1110.  
  1111.        Using the help menus on the side as a guide, type in the
  1112.        following entries under the "This" menu header:
  1113.  
  1114.        This
  1115.        Is
  1116.        One
  1117.        Menu
  1118.  
  1119.        Press the right-arrow key to move the selection header to "Is".
  1120.        Notice that the previous entries have disappeared. Press the
  1121.        left-arrow key. Notice that the entries have reappeared. Press
  1122.        the right-arrow key.
  1123.  
  1124.        Type in the following entries:
  1125.  
  1126.        This
  1127.        Is
  1128.  
  1129.        Now, without moving the cursor, press the F2 key.
  1130.        A "partition" will appear. Do not edit this partition. If you
  1131.        accidentally edit it, press F2, and another partition will be
  1132.        generated.
  1133.  
  1134.        Press the down-arrow key to leave the partition and type:
  1135.  
  1136.        Another
  1137.  
  1138.        Press the right-arrow key to move the header selection to "A".
  1139.  
  1140.                              Page 19
  1141.        Press the right-arrow key again to move the header selection to
  1142.        "tEst".
  1143.  
  1144.        Type in the following entries:
  1145.  
  1146.        One
  1147.        smAll
  1148.        Pull
  1149.        Down
  1150.        Menu
  1151.  
  1152.        When you are done typing those entries in press PgDn to go to
  1153.        page 3.
  1154.  
  1155.        Press Enter to enter the status help line for the entry "This".
  1156.  
  1157.        Type "This is nonsense" in the box that appears, and press ENTER.
  1158.  
  1159.        Press F5 to enter the status help line for the sub-menu "This".
  1160.        Type "This is ludicrous" in the box that appears, and press
  1161.        ENTER.
  1162.  
  1163.        Move the selection bar around, and enter other status help lines
  1164.        for other entries and menu headers.  Notice how you can't enter a
  1165.        status help line for the partition.
  1166.  
  1167.        Move to the "tEst" sub-menu. Press F2 a few times, and watch the
  1168.        underlying shadow disappear and reappear.
  1169.  
  1170.        Also notice that there are no entries under the "A" sub-menu.
  1171.  
  1172.        Press PgDn to go to page 4.
  1173.  
  1174.        On page 4 move the cursor around, and observe the sub-menus as
  1175.        they change from one to another. Move the cursor to the "This"
  1176.        sub-menu.
  1177.        Move the cursor to the "One" entry in that sub-menu. Press F5.
  1178.        You have just killed that entry. The entry will change into a
  1179.        neutral color. Press F5 again. Oops, you have just killed "Menu",
  1180.        and let's suppose you actually didn't want to kill it. Press F2,
  1181.        and F5 will change from "Kill" to "Revive". Move the selection
  1182.        bar to the dead entry "Menu", and press F5. "Menu" has just come
  1183.        back to life, and is displayed it's original color. If you have
  1184.        not grasped this concept yet, feel free to use the above methods
  1185.        to kill and revive other entries. NOTE: Make sure that F5 is in
  1186.        the right "mode". (either "Kill" or "Revive").
  1187.  
  1188.        Press PgDn to return to the "Design menus" icon-menu.
  1189.  
  1190.        Move the selection box to "Design Horizontal pop-up menus", and
  1191.        press ENTER.
  1192.  
  1193.        For the key name type "TESTING", without the quotes. Press ENTER
  1194.        to go to page 2.
  1195.  
  1196.        For the prompt, type "Are you sure?", without the quotes. Press
  1197.        ENTER to go to page 3.
  1198.  
  1199.  
  1200.  
  1201.                              Page 20
  1202.        For the colors, set the colors to your liking. If you need help,
  1203.        refer to page 13 on setting the colors. Press PgDn to go to page
  1204.        4.
  1205.  
  1206.        On page 4, you set the border style. At this time, just accept
  1207.        the default border style by pressing PgDn. Once you have
  1208.        experience with Turbo Designer, you should experiment with
  1209.        setting the border style.
  1210.  
  1211.        On page 5, you type in the entries for the pop up menu. Type in
  1212.        these entries: (refer to page 14 for more help)
  1213.        Yes
  1214.        No
  1215.        Cancel
  1216.  
  1217.        Press PgDn to go to page 6.
  1218.  
  1219.        Page 6 asks you whether or not you want a shadow. Press Enter,
  1220.        because you want a shadow.
  1221.  
  1222.        Page 7 shows you the pop up menu. Move it around by pressing the
  1223.        arrow keys. Press PgDn after you move it to a location that you
  1224.        feel is good. (For example, try and put it in the center of the
  1225.        screen)
  1226.  
  1227.        You will return to the "Design menus" icon menu.
  1228.  
  1229.        Move the selection box to "Design pop-up menus", and press ENTER.
  1230.  
  1231.  
  1232.        For the key name type "TEST2", without the quotes. Press ENTER to
  1233.        go to page 2.
  1234.  
  1235.        For the colors, set the colors to your liking. If you need help,
  1236.        refer to page 14 on setting the colors. Press PgDn to go to page
  1237.        3.
  1238.  
  1239.        On page 3, you set the border style. At this time, just accept
  1240.        the default border style by pressing PgDn. Once you have
  1241.        experience with Turbo Designer, you should experiment with
  1242.        setting the border style.
  1243.  
  1244.        On page 4, you type in the entries for the pop up menu. Type in
  1245.        these entries: (refer to page 15 for more help)
  1246.        {Leave a space between pOpcorn and Crackerjacks, type in the
  1247.        entries using the capital letters exactly as they are written
  1248.        here}
  1249.        Peanuts
  1250.        pOpcorn
  1251.  
  1252.        Crackerjacks
  1253.  
  1254.        Move the selection bar to the blank line between pOpcorn and
  1255.        Crackerjacks and press F2. A partition appears!
  1256.  
  1257.        Press PgDn to go to page 5.
  1258.  
  1259.  
  1260.                              Page 21
  1261.        Page 5 asks you whether or not you want a shadow. Press Enter,
  1262.        because you want a shadow.
  1263.  
  1264.        Page 6 shows you the pop up menu. Move it around by pressing the
  1265.        arrow keys. Press PgDn after you move it to a location that you
  1266.        feel is good. (For example, try and put it in the center of the
  1267.        screen)
  1268.  
  1269.        You will return to the "Design menus" icon menu.
  1270.  
  1271.        Press ESC to go to the "Main Menu" icon menu.
  1272.  
  1273.        Press the up-arrow key to go to the "Color constants and
  1274.        environment" icon.
  1275.  
  1276.        Press ENTER to enter the icon. Another icon menu appears.
  1277.  
  1278.        Press the right-arrow key to move to the icon "Set program's
  1279.        environment" and press ENTER.
  1280.  
  1281.        Press ENTER again to choose the "Select" option.
  1282.  
  1283.        Press the arrow keys to move the cursor to the first letter of
  1284.        your name and press ENTER.
  1285.  
  1286.        Press ENTER again to confirm your approval of the selection.
  1287.  
  1288.        On page two, type in the line "This is my status line".
  1289.  
  1290.        Press ENTER to go to page 3.
  1291.  
  1292.        On page three, press ENTER. This page should be used only when
  1293.        you are familiar with TURBO Designer's environment.
  1294.  
  1295.        Press ESC to go to the "Main Menu" icon menu.
  1296.  
  1297.        Press the right-arrow key to move the selection box to "Design
  1298.        HELP Screens" icon menu.
  1299.  
  1300.        Press ENTER to select this icon menu.
  1301.  
  1302.        Press ENTER to select the "Define help screens" icon.
  1303.  
  1304.        Type in "Help_Me", without the quotes, and press ENTER.
  1305.  
  1306.        Type in "My help screen"
  1307.  
  1308.        Move the cursor with you arrow keys to position (10,10).
  1309.  
  1310.        Press ENTER.
  1311.  
  1312.        Move the cursor with you arrow keys to position (60,15).
  1313.  
  1314.        Press ENTER.
  1315.  
  1316.        Press ENTER again.
  1317.  
  1318.        Press PgDn. When you have more experience, you may set the
  1319.        colors.
  1320.                              Page 22
  1321.        Press Enter. You will use a SINGLE BORDER.
  1322.  
  1323.        Press Enter. You want a shadow.
  1324.  
  1325.        Press Enter. You like that definition.
  1326.  
  1327.        Press Enter. You wish to make another help screen.
  1328.  
  1329.        Type in "More_help", without the quotes, and press ENTER.
  1330.  
  1331.        Type in "My other help screen" and press ENTER.
  1332.  
  1333.        Move the cursor with you arrow keys to position (10,10).
  1334.  
  1335.        Press ENTER.
  1336.  
  1337.        Move the cursor with you arrow keys to position (60,15).
  1338.  
  1339.        Press ENTER.
  1340.  
  1341.        Press ENTER again.
  1342.  
  1343.        Press PgDn. When you have more experience, you may set the
  1344.        colors.
  1345.  
  1346.        Press Enter. You will use a SINGLE BORDER.
  1347.  
  1348.        Press Enter. You want a shadow.
  1349.  
  1350.        Press Enter. You like that definition.
  1351.  
  1352.        Press the right-arrow key twice to move the selection box to
  1353.        "Enter help text" icon menu. Press ENTER to select.
  1354.  
  1355.        Press ENTER to select "Help_Me".
  1356.  
  1357.        Now, type in the sentence "May I help you?".
  1358.  
  1359.        Move the cursor to the bottom left corner.
  1360.  
  1361.        Type "Yes", without the quotes.
  1362.  
  1363.        Move the cursor to the Y again.
  1364.  
  1365.        * This stage is critical, try not to make a mistake! *
  1366.  
  1367.        Press F3.
  1368.  
  1369.        Press the right-arrow key two times.
  1370.  
  1371.        Press F3.
  1372.  
  1373.        Press the down-arrow key.
  1374.  
  1375.        Press ENTER.
  1376.  
  1377.        Move the cursor so that it is on the "Yes" somewhere.
  1378.  
  1379.        Press ENTER.
  1380.                              Page 23
  1381.        Type "Well, tough luck!", without the quotes.
  1382.  
  1383.        Press the END key.
  1384.  
  1385.        Press F10 to go to the pull down menus.
  1386.  
  1387.        Press the "F" key.
  1388.  
  1389.        Press the "S" key to save your work file.
  1390.  
  1391.        Press the left-arrow key twice to move to the "Generate" sub-
  1392.        menu.
  1393.  
  1394.        Press ENTER to generate.
  1395.  
  1396.        Press ENTER after the code is generated.
  1397.  
  1398.        Move to the "File" sub-menu, and press "Q"
  1399.  
  1400.        Press "N", because you have already saved it.
  1401.  
  1402.        Load TURBO Pascal.
  1403.  
  1404.        Making sure that you are in the same directory that you created
  1405.        TEST1.TD1 in (use Change Directory if needed), load TEST1.PAS.
  1406.  
  1407.        Run the file.
  1408.  
  1409.        Now, you have successfully design and executed a file from TURBO
  1410.        Designer. Try this a few more times, each time making your files
  1411.        more elaborate, then use it for serious work.
  1412.  
  1413.        USING TD1 AS A LIBRARY
  1414.  
  1415.            TD1 can be used as a standalone function library, or it's
  1416.        library can be used in conjunction with the generated code. The
  1417.        files that must be "used" in the TURBO Pascal program are these
  1418.        (in order): Uses Dos, Crt, TD1VARS, TD1VIDEO, TD1UTILS;
  1419.  
  1420.        The library functions that you can use are defined below.
  1421.  
  1422.        Function CalcColor(F,B : Byte) : Byte;
  1423.        This function is used to produce an ENCODED COLOR BYTE,
  1424.        using foreground F and background B.
  1425.  
  1426.        Usually, the foreground is stored in one byte, and the background
  1427.        is stored in another byte. It is possible to put these two colors
  1428.        into one byte. This byte is called an ENCODED COLOR BYTE.
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.                              Page 24
  1441.        Function MonoColor(C,R : Byte) : Byte;
  1442.        This function is used to insure that colors will appear correctly
  1443.        on a monochrome monitor.
  1444.        Parameters:
  1445.                C is the incoming color. It is an encoded color byte with
  1446.        a range of 0..255.
  1447.                R is the byte to change to. It is also an encoded color
  1448.        byte. If the monitor is a monochrome monitor, MonoColor returns
  1449.        R; otherwise it will return C. There is one exception: If R is
  1450.        255 and the monitor is a monochrome monitor, MonoColor returns an
  1451.        appropriate monochrome attribute to C.
  1452.  
  1453.        Examples:
  1454.                    Write(MonoColor(34,19));
  1455.        { Returns 19 if monochrome monitor, else returns 34 }
  1456.                    Write(MonoColor(CalcColor(Yellow, Black),White));
  1457.                    Write(MonoColor(CalcColor(Blue, Red), 255);
  1458.        {Returns Blue on Red if color monitor, White on Black otherwise}
  1459.  
  1460.        Procedure Wr(S : String; X, Y :Byte; F, B : Byte);
  1461.        This procedure writes a string at coordinates (X,Y) with colors F
  1462.        and B.
  1463.        Parameters: S is any type of string.
  1464.                    X is in the range 1..80.
  1465.                    Y is in the range 1..25.
  1466.                    F is the foreground color. It is not encoded.
  1467.                    B is the background color. It is not encoded.
  1468.        Examples:
  1469.        Wr('Hello',10,10,Blue, Green);
  1470.        Wr('It works!',15,15,MonoColor(Blue,255),MonoColor(Green,255));
  1471.        { MonoColor can also take a NON-ENCODED COLOR for it's C
  1472.        parameter }
  1473.  
  1474.  
  1475.  
  1476.        Procedure MkWin(Title       : String,
  1477.                        X1,Y1,X2,Y2 : Byte;
  1478.                        F, B        : Byte;
  1479.                        BorderStyle : Charray;
  1480.                        Shadow      : Boolean);
  1481.  
  1482.        This procedure creates a window on the screen with rectangular
  1483.        coordinates (X1,Y1) - (X2,Y2), with colors F and B, with a border
  1484.        style defined as BorderStyle. If Title <> '' then MkWin centers
  1485.        Title and displays it on the top border. If Shadow is true, then
  1486.        a shadow is displayed under the window.
  1487.        Parameters:
  1488.                  Title is any string.
  1489.                  1 <= X1 < X2 <= 80
  1490.                  1 <= Y1 < Y2 <= 25
  1491.                  F is the foreground color. It is not encoded.
  1492.                  B is the background color. It is not encoded.
  1493.        BorderStyle is a special type. It's value may be either
  1494.        EmptyBorder, SingleBorder, or DoubleBorder; depending on
  1495.        whether you want no border, a single line border, or a double
  1496.        line border, respectively.
  1497.  
  1498.         Creating a window will set TURBO Pascal's WriteLn window and
  1499.        colors.
  1500.                              Page 25
  1501.        Examples:
  1502.  
  1503.         MkWin('A window', 1,1,80,25, Blue, Red, SingleBorder,True);
  1504.         MkWin('Another window',20,10,60,20,Black,White,Emptyborder,False);
  1505.  
  1506.        Procedure RmWin;
  1507.        This procedure will remove the last window created and restore
  1508.        the area of the screen that the window covered.
  1509.  
  1510.        Examples:
  1511.  
  1512.          MkWin('',10,10,70,15,White, Black, DoubleBorder, True);
  1513.           WriteLn('Look at this window.....');
  1514.            Repeat
  1515.            Until ReadKey = #27;
  1516.          RmWin;
  1517.  
  1518.        Procedure Help(S:Str20);
  1519.        This procedure will invoke a help screen with key S.
  1520.        Examples:
  1521.                   Help('Help_Screen_One');
  1522.                   Help('Help_Index');
  1523.                   Help('DoHelp');
  1524.  
  1525.        Procedure Directory;
  1526.        Making a call to this procedure will invoke a pop up directory
  1527.        listing as described in "POP UP DIRECTORY"
  1528.        Procedure TrashFile;
  1529.        Calling this procedure will accomplish the first step of the
  1530.        trash can, described in the section "TRASH CAN".
  1531.  
  1532.        Procedure TrashGroup;
  1533.        Calling this procedure will accomplish the trash group function,
  1534.        as described in the section "TRASH CAN".
  1535.  
  1536.  
  1537.        Procedure EditTrashCan;
  1538.        Calling this procedure will invoke the second step of the trash
  1539.        can, described in the section "TRASH CAN".
  1540.  
  1541.        Procedure EmptyTrash;
  1542.        Calling this procedure will complete the third step of the trash
  1543.        can, described previously in the section "TRASH CAN".
  1544.  
  1545.        Function GetFileName : String;
  1546.        Calling this procedure will accomplish the same task described in
  1547.        LOAD WORK FILE.
  1548.        Example:
  1549.                  Var S : String;
  1550.                    .
  1551.                    .
  1552.                    .
  1553.                    S := GetFileName;
  1554.  
  1555.        Procedure Error(S : String);
  1556.        When you call this procedure, an error box will appear with
  1557.        message S in it.
  1558.        Example:
  1559.                Error('No files found.');
  1560.                              Page 26
  1561.        Procedure Do_clock;
  1562.        This procedure uses the Access system clock icon, and prompts the
  1563.        user for the time and date.
  1564.  
  1565.        Procedure ChangeDir;
  1566.        This procedure uses the same routine that the FILE sub-menu uses
  1567.        in the "Change directory" option.
  1568.  
  1569.        WHAT'S NEXT?
  1570.  
  1571.           After finishing version 2.0, I started to think about what
  1572.        will be in the next version. Here is what I have come up with for
  1573.        possibilities.
  1574.  
  1575.         1) A few nagging bugs will be fixed.
  1576.  
  1577.         2) The directory will scroll.
  1578.  
  1579.         3) I will probably allow the design of DATA SCREENS.
  1580.  
  1581.         4) There will be a mouse.
  1582.  
  1583.         5) The keyboard will be enhanced.
  1584.  
  1585.         6) Probably more "boxed" procedures will be written.
  1586.  
  1587.         7) I/O errors will be handled better.
  1588.  
  1589.         8) TD1 will generate code for TURBO Pascal version 5.0 ONLY!!!
  1590.            (or the latest version of TURBO Pascal)
  1591.  
  1592.         9) If you have any suggestions, feel free to tell me.
  1593.  
  1594.        SHAREWARE AND TURBO DESIGNER
  1595.  
  1596.         ShareWare is a method of distribution where making copies of the
  1597.        software and distributing them to friends is encouraged. Each
  1598.        copy should be used and evaluated. After the evaluation, the user
  1599.        should determine whether or not the price that the Author of the
  1600.        ShareWare package asks for is reasonable. If it is, the user, to
  1601.        perpetuate the ShareWare concept, should pay the Author the
  1602.        suggested price.
  1603.  
  1604.         The price that I am asking for TURBO Designer is US $25. Add $5
  1605.        for foreign orders. See the order form on page 30 for details.
  1606.  
  1607.         If you register, I will send you a disk with your registration
  1608.        number on it. If you share this disk, and somebody registers with
  1609.        your registration number, I will send you a $10 commission. It is
  1610.        a simple thank you for registering.
  1611.  
  1612.         If you do not feel like registering, please send me your name
  1613.        and address anyways. I will send you update notices as the new
  1614.        versions come out.
  1615.  
  1616.         If you have any comments regarding TURBO Designer, please tell
  1617.        me. It is my hope that users of this software package, registered
  1618.        or not, will communicate.
  1619.  
  1620.                              Page 27
  1621.         If you have a ShareWare package, please tell me about it.
  1622.        Whether or not you are a registered user, I will place the
  1623.        description you send me in this manual. If you send me a disk
  1624.        with your program on it, I will put a review, and your response
  1625.        to that review, in this manual. I don't really care whether or
  1626.        not your ShareWare package uses TURBO Designer, I just want to
  1627.        list as many ShareWare packages as I can.
  1628.  
  1629.        DISTRIBUTING TURBO DESIGNER
  1630.  
  1631.         You may distribute UNMODIFIED copies of TURBO Designer to anyone
  1632.        and everyone, just as long as a fee of no more than $10 is
  1633.        charged.
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.                              Page 28
  1681.        FILES ON THIS DISK
  1682.  
  1683.         No documentation would ever be complete without a listing of
  1684.       all the files. Well, here it is.
  1685.  
  1686.  
  1687.                     A listing of all files....
  1688.          --------------------------------------------------------------
  1689.                    TD1.EXE - The main program file
  1690.                    TD1.DOC - The documentation for TD1
  1691.  
  1692.                    TD1.HIN \
  1693.                    TD1.HLI - Help screens for TD1.EXE
  1694.                    TD1.HTE /
  1695.  
  1696.                TP4VARS.TPU \
  1697.               TP4VIDEO.TPU - Library code for TURBO Pascal 4.0
  1698.               TP4UTILS.TPU /
  1699.  
  1700.                TP5VARS.TPU \
  1701.               TP5VIDEO.TPU - Library code for TURBO Pascal 5.0
  1702.               TP5UTILS.TPU /
  1703.  
  1704.                TP4INST.BAT Batch file to install for TURBO Pascal 4.0
  1705.                TP5INST.BAT Batch file to install for TURBO Pascal 5.0
  1706.  
  1707.               PRINTDOC.BAT Batch file to print documentaion on printer
  1708.               FILELIST.DOC This file
  1709.                 README.1ST Read this file before attempting to run TD1
  1710.          --------------------------------------------------------------
  1711.  
  1712.                      Well, there it is. Have fun!
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.                              Page 29
  1741. REGISTRATION FORM
  1742.  
  1743.             Product                    Cost   How many    Price
  1744.  
  1745.      TURBO Designer  Registration    $25.00 x ________  = _____
  1746.         version 2.0
  1747.  
  1748.                                                  SubTotal:_____
  1749.  
  1750.                                        Foreign orders add: $5
  1751.  
  1752.                                                     Total:_____
  1753.  
  1754.          Comments,questions, or complaints: (if any, feel free)
  1755.  
  1756.               ________________________________________________
  1757.  
  1758.               ________________________________________________
  1759.  
  1760.               ________________________________________________
  1761.  
  1762.               ________________________________________________
  1763.  
  1764.               ________________________________________________
  1765.  
  1766.               ________________________________________________
  1767.  
  1768.               ________________________________________________
  1769.  
  1770.                           *           *           *
  1771.                       Only check or money order, please.
  1772.  
  1773.              Cash will be sent back at your expense. (and risk)
  1774.  
  1775.              Expect orders in about 2-4 weeks.
  1776.  
  1777.              Make checks and money orders to: Michael McMahon
  1778.  
  1779. Send to:  MMI Computers  TD will be sent to this return address:
  1780.           Attn: SLO-0000
  1781.           878 Via Seville
  1782.           Livermore, Ca.     ____________________________________
  1783.           94550 USA
  1784.  
  1785.                              ____________________________________
  1786.  
  1787.  
  1788.                              ____________________________________
  1789.  
  1790.  
  1791.                              ____________________________________
  1792.  
  1793.  
  1794.                              ____________________________________
  1795.  
  1796.  
  1797.                              ____________________________________
  1798.  
  1799.  
  1800.                              Page 30