WINDOW statement

The WINDOW statement - creating a new window.

Syntax

WINDOW name [caption] type [options];

The options that appear at the end of the statement can be specified one after another in any order:

HIDETITLE 
HIDESCROLLBARS 
DRAWROOT 
orientationType
POSITION(x, y, width, height)
fixedPositionType
HALIGN(alignType)
VALING(alignType) 
TEXTHALIGN(alignType)
TEXTVALIGN(alignType)

Description

The WINDOW statement declares a new window and adds it to the current module.

Parameters

• name

  Window name. Simple ID. The name must be unique within the current namespace.

• caption

  Window caption. String literal. If caption is not specified, the window's name will be used as the caption.

• type

  warning

  The window type is declared deprecated. In future versions of the platform, only behavior similar to using the TOOLBAR keyword will be supported. Explicit specification of the window type will need to be removed.

  Type of window to create. Specified with one of the keywords TOOLBAR, PANEL, TREE, or MENU.

Options

• HIDETITLE

  Keyword specifying that no caption should be displayed in the user interface.

• HIDESCROLLBARS

  Keyword specifying that no scrollbars should be displayed for this window.

• DRAWROOT

  warning

  The option is declared deprecated. It will not be supported in future versions of the platform.

  Keyword specifying that the navigator elements whose descendants will be added to this window will also be added to it.

• orientationType

  Specifying the vertical or horizontal orientation of the toolbar or panel being created. Specified by one of the keywords:

  • VERTICAL - vertical orientation (default value).
  • HORIZONTAL - horizontal orientation.

  This option only makes sense for TOOLBAR or PANEL windows.

• POSITION (x, y, width, height)

  Specifying the size and location of the window.

  • x

    The left window coordinate. Integer literal ranging from 0 to 100.

  • y

    Top window coordinate. Integer literal ranging from 0 to 100.

  • width

    Window width. Integer literal ranging from 0 to 100.

  • height

    Window height. Integer literal ranging from 0 to 100.

• fixedPositionType

  Specifying a fixed location of the window on the desktop, which does not allow the user to change its position and size. Here the window size is automatically determined based on the preferred dimensions of the component. The window will be located to the left, right, top, and bottom of the desktop, respectively. This option only makes sense for TOOLBAR windows and cannot be used simultaneously with the POSITION option. Specified by one of the keywords:

  • LEFT
  • RIGHT
  • TOP
  • BOTTOM

• HALIGN(alignType)

  Specifying the horizontal alignment of the buttons in a vertical toolbar. This option only makes sense for TOOLBAR windows with VERTICAL orientation.

  • alignType

    Alignment type. This is specified using one of these keywords:

    • START - left alignment (default value).
    • CENTER - center alignment.
    • END - right alignment.

• VALIGN(alignType)

  Specifying the vertical alignment of the buttons in a horizontal toolbar. This option only makes sense for TOOLBAR windows with HORIZONTAL orientation.

  • alignType

    Alignment type. This is specified using one of these keywords:

    • START - top alignment (default value).
    • CENTER - center alignment.
    • END - bottom alignment.

• TEXTHALIGN(alignType)

  Specifying the horizontal alignment of text on the buttons.

  • alignType

    Alignment type. This is specified using one of these keywords:

    • START - left alignment (default value).
    • CENTER - center alignment.
    • END - right alignment.

• TEXTVALIGN(alignType)

  Specifying the vertical alignment of text on the buttons.

  • alignType

    Alignment type. This is specified using one of these keywords:

    • START - top alignment.
    • CENTER - center alignment (default value).
    • END - bottom alignment.

Examples

// creating system windows in the System module
WINDOW root 'Root' TOOLBAR HORIZONTAL POSITION(0, 0, 100, 6) VALIGN(CENTER) HIDETITLE HIDESCROLLBARS;
WINDOW toolbar 'Toolbar' TOOLBAR VERTICAL POSITION(0, 6, 20, 64) HIDETITLE;
WINDOW tree 'Tree' TOOLBAR POSITION(0, 6, 20, 64) HIDETITLE;

// a horizontal toolbar at the bottom of the desktop, in which all buttons will be centered and text will be aligned up
// in this toolbar, for example, it is possible to place forms for quick opening
WINDOW hotforms TOOLBAR HORIZONTAL BOTTOM VALIGN(CENTER) TEXTVALIGN(START);