Previous Index Next

The VisKProg form file description 0.8

A VisKProg form file is a file that contains the description of VisKProg formulars ( i.e. windows and subwindows ), and is usually autogenerated as a saved file from KWindedit. They are needed by the form translator, which makes c++-code, describing the form. This documentation is designed to give you the posibility to check whether KWinedit has produced correct output, and to manipulate its output.

  • VisKProg form files have the suffix ".vkf" for sub windows and ".vktf" for topwidgets (windows).
  • They describe type and name of a form, as well as its properties and all sub widgets, regional variables, constants and functions the form has.
  • The first word is the type of the form, i.e Window or Widget, followed by its name. This part of the file is called the form declaration.
  • The declaration is followed by the form description in parenthesis.
    So, a form file for a window called win with empty description would look like this:
    Window win
    (
    )
  • The description is splitted in five parts: The property description, the variables, constants, functions, and the sub widget description.
  • Each of these parts is also splitted in a declaration ( one of the keywords Properties, Regional (regional variables), RegConst (regional constants), Functions or SubWidgets ) and a description.
  • The description of "Properties" is a semicolon separated list of lines of the form:
    Property_name = "Value";
    Please note, that you've got to set EVERY property of the form excepted the "Name" property, even those that should keep the default value. Example:
    Width = "100";
  • The "Name" property is never defined, since the name is allready present in the declaration.
  • The description of "Regional" is a semicolon separated list of lines of the form:
    VaribaleName = "Initial value";
  • The description of "RegConst" is a semicolon separated list of lines of the form:
    ConstantName = "Value";
  • The description of "Functions" is a semicolon separated list of lines of the form:
    FunctionName: Number_of_Arguments;
    Example:
    MyFunction: 0;
  • The description of "SubWidgets" is once more splitted in declaration and description, where the declaration is:
    WidgetType:WidgetName
    and the description is just a list of the widgets properties.
  • Correct widget types are: Widget (simply a sub window), Button and Label.
  • Tip: An example file is stored in "example.tvkf".

  • Christoph Pinkel, Dec 1999