DISPLAY assembly-name

Format 18

DISPLAY assembly-name instantiates a graphical .NET control or assembly.

DISPLAY {assembly-name       }
        {OBJECT assembly-name}

NAMESPACE { IS } "namespace"

CLASS-NAME { IS } "class-name"

Remaining phrases are optional.

HANDLE { IS } handle-1
VERSION { IS } "version"

CULTURE { IS } "culture"

STRONG-NAME { IS } "strong-name"

CONSTRUCTOR { IS } CONSTRUCTOR[n] parameters...

MODULE { IS } "module"

FILE-PATH { IS } "file-path"

AT LINE NUMBER line-num   [CELL  ]
                          [CELLS ]
                          [PIXEL ]
                          [PIXELS]

AT {COLUMN  } NUMBER col-num   [CELL  ]
   {COL     }                  [CELLS ]
   {POSITION}                  [PIXEL ]
   {POS     }                  [PIXELS]

SIZE  {IS} length [CELL  ]
      {= }        [CELLS ]
                  [PIXEL ]
                  [PIXELS]

LINES {IS} height [CELL  ]
      {= }        [CELLS ]
                  [PIXEL ]
                  [PIXELS]

Syntax Rules

  1. assembly-name is the name of a .NET assembly defined in a COPY file created by NETDEFGEN. This must be the DLL name of a graphical control, not an executable file. Graphical controls are generated by Visual Studio when a developer selects a Windows Control Library project type.
  2. handle-1 is a USAGE HANDLE or PIC X(10) data item assigned to the graphical .NET assembly. The HANDLE phrase can be specified anywhere in the statement after the initial elements.
  3. A value surrounded by quotation marks is an alphanumeric literal and is case-sensitive. Literal values for assembly parameters are located in the COPY file generated by NETDEFGEN. The same COPY file must be included in the SPECIAL-NAMES paragraph of your program.
  4. line-num, col-num, length, and height are numeric data items or literals. They may be non-integer values, except when pixels are specified. They may be numeric expressions.

General Rules

  1. The Format 18 DISPLAY statement is only for graphical .NET assemblies. Graphical assemblies show the keyword VISUAL in the COPY file after the CLASS keyword. If the word "VISUAL" does not appear, use the CREATE statement to instantiate the assembly.
  2. assembly-name is the name of a .NET assembly defined in the NETDEFGEN COPY file. This must be a DLL name or a control name, not an executable.
  3. namespace is a NameSpace in the assembly, as it appears in the COPY file.
  4. class-name is a class in the NameSpace.
  5. version is the version number of the assembly.
  6. culture is cultural information related to the assembly.
  7. strong-name is the cryptographic key required to access the assembly, if any. If the assembly requires such a key, as all assemblies in the Global Assembly Cache (GAC) do, it is shown in the COPY file under the keyword STRONG.
  8. All classes that result in an object have a CONSTRUCTOR, which is a sort of method. If you see a CONSTRUCTOR identifier in the COPY file without a parameter list, then the field may be omitted from your COBOL program. If all listed CONSTRUCTORs have parameters, then you must choose which CONSTRUCTOR and parameters to use. Constructor(n) is the constructor that you want to use followed by its parameter data.
  9. module identifies a file where a combination of NameSpaces and Classes reside. It is used when the assembly is constructed of other assemblies.
  10. file-path is the path of an XML file, and that XML file contains the path where the .NET assembly is located. Use FILE-PATH when the assembly that you want to access does not reside in the GAC or in the same directory as wrun32.exe. Assemblies that reside in the GAC will have the STRONG keyword in the NETDEFGEN COPY file.
  11. LINES and SIZE default to the design control height and width.