DLDIV (Definition List Divider)

The DLDIV tag creates a blank or visible divider within the text portion of an application panel.

Syntax


>>-<DLDIV--+-----------------+--+--------------+---------------->
           |       .-NONE--. |  |      .-YES-. |   
           '-TYPE=-+-SOLID-+-'  '-GAP=-+-NO--+-'   
                   +-DASH--+                       
                   '-TEXT--'                       

>--+---------------+--+--------------------+-------------------->
   |         .-1-. |  '-FORMAT=-+-START--+-'   
   '-GUTTER=-+-n-+-'            +-CENTER-+     
                                '-END----'     

>-->--+--------------+--+----------+---------------------------><
      '-divider-text-'  '-</DLDIV>-'

Parameters

TYPE=NONE | SOLID | DASH | TEXT: This attribute specifies the type of divider line. The line width is one character.
The default value is NONE, which produces a blank line. You must specify SOLID, DASH, or TEXT to produce a visible divider line. When the GRAPHIC invocation option is specified, SOLID produces a solid line for host display and DASH produces a dashed line. When NOGRAPHIC is specified or the panel is displayed in GUI mode, both SOLID and DASH produce a dashed line.
GAP=YES | NO: When GAP=NO, the divider line completely crosses from one side of the text area to the other. When GAP=YES, a 1-character gap remains at each end of the divider line.
GUTTER=1 | n: This attribute specifies the total width of the divider. If the GUTTER value is an even number, the conversion utility increases the number by 1 so that the divider is centered within the defined width.
The minimum GUTTER value, and the default, is 1.
FORMAT=START | CENTER | END: This attribute specifies the position of the divider text within the width of the divider line.
divider-text: This is the text of the area divider line.

Comments

The DLDIV tag creates a blank or solid divider within the text portion of an application panel. A horizontally formatted visible divider is created when you specify the TYPE attribute value as SOLID or DASH. When the GRAPHIC invocation option is specified, SOLID produces a solid line for host display and DASH produces a dashed line. When NOGRAPHIC is specified or the panel is displayed in GUI mode, both SOLID and DASH produce a dashed line.

The divider line can be formatted with descriptive text. When this feature is used, the FORMAT attribute must be specified. If FORMAT is not specified, the tag text is ignored. You control the text padding with the TYPE attribute. If TYPE=TEXT, the divider-text is padded with blanks. When TYPE=SOLID or TYPE=DASH, the divider-text is padded with the specified character.

Restrictions

You must code the DLDIV tag within a DL tag.

Processing

Table 1. The tags you can code within a DLDIV definition
Tag	Reference	Usage	Required
HP	HP (Highlighted Phrase)	Multiple	No

Examples

Here is an example that shows the use of the DLDIV tag in combination with the multiple DT tag function and the DIVEND attribute of the DL tag. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM>

<HELP NAME=dldiv DEPTH=22 WIDTH=60>Employee Code Help
  <AREA>
  <INFO>
    <P>The following list defines the valid employee codes.
    <DL TSIZE=14 BREAK=none>
      <DLDIV TYPE=SOLID>
      <DTHD>Code
      <DDHD>Meaning
      <DLDIV TYPE=SOLID>
      <DT NOSKIP>Full-time
      <DD>Indicates that the employee works a
      regular schedule of 40 hours or more weekly.
      <DT>Part-time
      <DD>Indicates that the employee works a regular
      schedule of 20 to 40 hours weekly.
      <DT>Supplemental
      <DD>Indicates that the employee works less than
      20 hours weekly.
      No regular schedule is in place.
    </DL>
  </INFO>
  </AREA>
</HELP>

Figure 1. Definition list dividers

                    Employee Code Help

 The following list defines the valid employee codes.
 ----------------------------------------------------------
 Code          Meaning
 ----------------------------------------------------------
 Full-time     Indicates that the employee works a regular
               schedule of 40 hours or more weekly.

 Part-time     Indicates that the employee works a regular
               schedule of 20 to 40 hours weekly.

 Supplemental  Indicates that the employee works less than
               20 hours weekly. No regular schedule is in
               place.