home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_300 / 327_01 / help3.txt < prev    next >
Text File  |  1991-10-09  |  6KB  |  199 lines
  1. +                              TEXT FILE FORMAT
  2.  
  3.     A panel text file begins with an optional size statement followed by an
  4.  optional background statement.  One or more tag statements are used to relate
  5.  field attributes and field names to special characters or symbols.  After the
  6.  tag statements is the actual screen layout, which must begin with a tagged
  7.  symbol.
  8.  
  9. +      size <ul_row> <ul_col> <lr_row> <lr_col>
  10. +      background <color>
  11. +      tag <symbol> <attributes> <variable>...<variable>
  12. +         .
  13. +         .
  14. +         .
  15. +      <symbol> ........................................
  16. +      .................................................
  17. +      .................................................
  18. +         .
  19. +         .
  20. +         .
  21. +                              SIZE STATEMENT
  22.  
  23.     This is an optional panel statement, and if present must precede the
  24.  background statement or the first tag statement.  This statement simply
  25.  sets the size of the window in which the panel will be constructed.
  26.  
  27.     Format:
  28. +              size <ul_row> <ul_col> <lr_row> <lr_col>
  29.  
  30.     where:
  31.                <ul_row> is the upper left row of the window
  32.                <ul_col> is the upper left column of the window
  33.                <lr_row> is the lower right row of the window
  34.                <lr_col> is the lower right column of the window
  35.  
  36.     Example:
  37.                size 0 0 13 39   Defines a panel to be 14 rows by 40 columns
  38.                                 located in the upper left part of the screen.
  39.  
  40.  
  41.  If a size statement is not present within a panel definition, the default
  42.  window coordinates are 0,0 and 24,79.  If a panel is defined to be smaller
  43.  than the previous active panel, the previous panel will be partially visible
  44.  behind the new panel.  However, the overlaid panel will not be active again
  45.  until the new panel is destroyed (i.e. no I/O functions may be performed on
  46.  the previous panel).
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. +                           BACKGROUND STATEMENT
  62.  
  63.     This is an optional panel statement, and if present must precede the first
  64.  tag statment.  This statement simply sets the screen background color when
  65.  a CGA adapter is in use.  If a monochrome adapter is in use the background
  66.  statement is ignored.
  67.  
  68.     Format:
  69. +                background <color>
  70.  
  71.        where <color> is a digit 0 - 7
  72.  
  73.     Color codes:  0 = Black (Default)
  74.                   1 = Blue
  75.                   2 = Green
  76.                   3 = Cyan
  77.                   4 = Red
  78.                   5 = Magenta
  79.                   6 = Brown
  80.                   7 = White
  81. +                              TAG STATEMENT
  82.  
  83.     A tag statement allows you to relate a special character or symbol with
  84.  a field definition.  This definition includes the field attributes as well
  85.  as the field names.
  86.  
  87.     Format:
  88. +                tag <symbol> <attributes> <variable list>
  89.  
  90.     <Attributes>:   P = Protected, U = Unprotected
  91.                     H = High Intensity, L = Low Intensity
  92.                     B = Blink
  93.                     R = Reverse
  94.                     _ = Underline
  95.                     D = Dark
  96.                     0    \
  97.                     1     \
  98.                     .      Foreground Color Code
  99.                     .     /    (as defined for background)
  100.                     7    /
  101.     Some attributes may have no effect with certain monitor types (i.e. the
  102.  color codes will have no effect using a monochrome display adapter).
  103.  
  104.  
  105.     <variable list>:  one or more field names separated by at least
  106.            one blank.  Valid names are no more than eight characters
  107.            begining with a letter.  No special characters are allowed.
  108.  
  109.     Each variable or field name is matched to a field on the screen layout.
  110.  If more fields are defined with the tag symbol than variables in the list,
  111.  the last variable name in the list is used to name the remaining fields.
  112.  In this case, a subscript other than 1 is used to access like named
  113.  fields.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121. +                                EXAMPLES
  122.  
  123.  
  124. +   tag % p
  125. +   tag & uh field
  126. +   %         Example 1
  127. +
  128. +         Name:&               %
  129. +
  130. +         Addr:&               %
  131.  
  132.  
  133.     In this example, there are two unprotected fields.  The first field would
  134.     be accessed using the name  FIELD  subscripted by 1, and the second would
  135.     be called  FIELD  with a subscript of 2.
  136.  
  137. +                    Press <F1> to activate this panel.
  138.  
  139.     Try moving the cursor from field to field with the tab key, and
  140.     experiment with entering some actual data.
  141. +   background 1
  142. +   tag ! p4
  143. +   tag @ pr7
  144. +   tag * u_2 select
  145. +   !         Example 2
  146. +
  147. +         @1.  Spreadsheet!
  148. +         @2.  Word Processor!
  149. +         @3.  Database!
  150. +
  151. +           Select-->* !
  152.  
  153.  
  154.     The screen background color is defined to be blue.  The ! symbol defines
  155.     protected red fields.  The @ symbol defines protected, reverse fields with
  156.     white characters.  The asterisk tagged field is named  SELECT  and
  157.     will be unprotected, underlined and green.
  158.  
  159. +                    Press <F2> to activate this panel.
  160.  
  161. +   size 10 30 16 56
  162. +   background 7
  163. +   tag ! p4
  164. +   !╔══════ Example 3 ══════╗
  165. +    ║ Here is a small panel ║
  166. +    ║ sized down to appear  ║
  167. +    ║ as a window on top of ║
  168. +    ║ the previously active ║
  169. +    ║ panel.                ║
  170. +    ╚═══════════════════════╝
  171.  
  172.  
  173.     The screen background color is defined to be white.  The ! symbol defines
  174.     protected red fields.  This example demonstrates the use of the size
  175.     statement.  The panel is defined as a 7 x 27 character box to be displayed
  176.     in the lower right part of the screen.
  177.  
  178. +                   Press <F3> to activate this panel.
  179.  
  180.  
  181. +                              PANEL DESIGN
  182.  
  183.  
  184.     Try your hand at designing your own panel!  Use any word processor to
  185.     create the panel file.  Be sure your file has an extension of PAN.
  186.  
  187.     Optionally, you may use IPD to create and modify a panel, type:
  188.  
  189. +                            ipd [<fn>]
  190.  
  191.     After your panel text file has been created, type:
  192.  
  193. +                            showpan <fn>
  194.  
  195.     where <fn> is your panel file name without the .PAN extension.
  196.  
  197.  
  198.                            *** END OF TOPIC ***
  199.