Инструкция WINDOW

Инструкция WINDOW - создание нового окна, инструкция HIDE WINDOW - скрытие существующего окна.

Синтаксис

WINDOW name [caption] [NATIVE] [options];

Опции options, которые идут в конце инструкции, могут быть указаны друг за другом в произвольном порядке:

HIDETITLE 
HIDESCROLLBARS 
orientationType
POSITION(x, y, width, height)
fixedPositionType
HALIGN(alignType)
VALIGN(alignType)
TEXTHALIGN(alignType)
TEXTVALIGN(alignType)
CLASS cssClassExpr

Существующее окно можно скрыть отдельной инструкцией:

HIDE WINDOW windowName;

Описание

Инструкция WINDOW объявляет новое окно и добавляет его в текущий модуль.

По умолчанию создаётся окно, в котором отображаются элементы навигатора.

Инструкция HIDE WINDOW скрывает указанное окно, делая его невидимым. Например, скрытие окна System.log приводит к тому, что сообщения пользователю выдаются в виде системных диалоговых форм.

Параметры

• name

  Имя окна. Простой идентификатор. Имя должно быть уникально в пределах текущего пространства имен.

• caption

  Заголовок окна. Строковый литерал. Если заголовок не задан, то заголовком окна будет являться его имя.

• NATIVE

  Ключевое слово, указывающее, что окно наполняет клиент, а не навигатор: поместить в него элементы навигатора нельзя. Так заданы предопределённые окна System.forms, в котором открываются формы, и System.log, в котором выводятся сообщения пользователю. Для такого окна применяются только опции POSITION, CLASS, HIDETITLE и HIDESCROLLBARS, а ориентация и выравнивание не учитываются.

• windowName

  Имя скрываемого окна. Составной идентификатор существующего окна.

Опции инструкции

• HIDETITLE

  Ключевое слово, указывающее на отсутствие заголовка окна в пользовательском интерфейсе.

• HIDESCROLLBARS

  Ключевое слово, указывающее на отсутствие скроллбаров для компонента данного окна.

• orientationType

  Указание вертикальной или горизонтальной ориентации создаваемого тулбара или панели. Задается одним из ключевых слов:

  • VERTICAL - вертикальная ориентация (значение по умолчанию).
  • HORIZONTAL - горизонтальная ориентация.

• POSITION(x, y, width, height)

  Указание размеров и местоположения окна.

  • x

    Крайняя левая координата окна. Целочисленный литерал в диапазоне от 0 до 100.

  • y

    Крайняя верхняя координата окна. Целочисленный литерал в диапазоне от 0 до 100.

  • width

    Ширина окна. Целочисленный литерал в диапазоне от 0 до 100.

  • height

    Высота окна. Целочисленный литерал в диапазоне от 0 до 100.

• fixedPositionType

  Указание фиксированного расположения окна на рабочем столе, которое не позволяет пользователю изменять его положение и размер. Размер окна в таком случае выбирается автоматически исходя из предпочитаемых размеров компонента. Окно будет расположено слева, справа, сверху, снизу рабочего стола соответственно. Опция не может быть использована одновременно с опцией POSITION. Задается одним из ключевых слов:

  • LEFT - расположение слева
  • RIGHT - справа
  • TOP - сверху
  • BOTTOM - снизу

• HALIGN(alignType)

  Указание горизонтального выравнивания кнопок в вертикальном тулбаре.

  • alignType

    Тип выравнивания. Задается с помощью одного из ключевых слов:

    • START - выравнивание по левому краю (значение по умолчанию).
    • CENTER - выравнивание по центру.
    • END - выравнивание по правому краю.

• VALIGN(alignType)

  Указание вертикального выравнивания кнопок в горизонтальном тулбаре.

  • alignType

    Тип выравнивания. Задается с помощью одного из ключевых слов:

    • START - выравнивание по верхнему краю (значение по умолчанию).
    • CENTER - выравнивание по центру.
    • END - выравнивание по нижнему краю.

• TEXTHALIGN(alignType)

  Указание горизонтального выравнивания текста на кнопках.

  • alignType

    Тип выравнивания. Задается с помощью одного из ключевых слов:

    • START - выравнивание по левому краю (значение по умолчанию).
    • CENTER - выравнивание по центру.
    • END - выравнивание по правому краю.

• TEXTVALIGN(alignType)

  Указание вертикального выравнивания текста на кнопках.

  • alignType

    Тип выравнивания. Задается с помощью одного из ключевых слов:

    • START - выравнивание по верхнему краю.
    • CENTER - выравнивание по центру (значение по умолчанию).
    • END - выравнивание по нижнему краю.

• CLASS cssClassExpr

  Указание имени CSS-класса для DOM-элемента, создаваемого для компонента окна в HTML. Может быть использовано для применения пользовательских стилей.

  • cssClassExpr

    Выражение, значение которого определяет имя класса.

Примеры

// cоздание системных окон в модуле System
WINDOW logo HORIZONTAL POSITION(0, 0, 10, 6) VALIGN(CENTER) HALIGN(START) HIDETITLE HIDESCROLLBARS CLASS logoWindowClass();
WINDOW root HORIZONTAL POSITION(10, 0, 70, 6) VALIGN(CENTER) HALIGN(CENTER) HIDETITLE HIDESCROLLBARS CLASS rootWindowClass();
WINDOW system HORIZONTAL POSITION(80, 0, 20, 6) VALIGN(CENTER) HALIGN(END) HIDETITLE HIDESCROLLBARS CLASS systemWindowClass();

WINDOW toolbar VERTICAL POSITION(0, 6, 20, 94) HIDETITLE CLASS toolbarWindowClass();

// в forms открываются формы, в log выводятся сообщения
WINDOW forms NATIVE POSITION(20, 6, 80, 94) CLASS formsWindowClass();
WINDOW log NATIVE POSITION(80, 6, 20, 93) HIDETITLE CLASS logsWindowClass();

// горизонтальное окно внизу рабочего стола, в котором все кнопки будут выравниваться по центру, а текст - выравниваться вверх
// в это окно можно, например, помещать формы для быстрого открытия
WINDOW hotforms HORIZONTAL BOTTOM VALIGN(CENTER) TEXTVALIGN(START);

// скрытие предопределённого окна сообщений (тогда сообщения выдаются диалоговыми формами)
HIDE WINDOW System.log;