advr.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
$FORM Metacommand Details
  Summary  Details  Example                Contents  Index  Back
──────────────────────────────────────────────────────────────────────────────
 {REM | '} $FORM formname
 
 Usage Notes
   ■ Use the $INCLUDE metacommand to group $FORM metacommands. For example,
     the project below contains three form modules:
 
         ┌──FORM1.FRM──┐     ┌──FORM2.FRM──┐     ┌──FORM3.FRM──┐
         │             │     │             │     │             │
         │'$FORM Form2 │     │'$FORM Form1 │     │'$FORM Form1 │
         │'$FORM Form3 │     │'$FORM Form3 │     │'$FORM Form2 │
         └─────────────┘     └─────────────┘     └─────────────┘
 
     Without an $INCLUDE file, you would have to make sure that each form
     module contains the appropriate $FORM metacommands in order to share
     form properties.
 
   ■ As your project grows, this type of file maintenance can become tedious.
     It is easier to create and maintain a single include file that contains
     your $FORM metacommands. For example:
 
                             ┌───FORMS.BI──┐
                             │             │
             ┌───────────────│'$FORM Form1 │───────────────┐
             │               │'$FORM Form2 │               │
             │               │'$FORM Form3 │               │
             │               └─────────────┘               │
             │                      │                      │
             ▼                      ▼                      ▼
  ┌──────FORM1.FRM──────┐┌──────FORM2.FRM──────┐┌──────FORM3.FRM──────┐
  │                     ││                     ││                     │
  │'$INCLUDE 'FORMS.BI' ││'$INCLUDE 'FORMS.BI' ││'$INCLUDE 'FORMS.BI' │
  └─────────────────────┘└─────────────────────┘└─────────────────────┘