Перейти к основному содержимому
Версия: 5.x

Инструкция WINDOW

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

Синтаксис​

WINDOW name [caption] type [options];

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

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

Описание​

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

Параметры​

  • name

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

  • caption

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

  • type

    warning

    Выбор типа окна объявлен устаревшим. В будущих версиях платформы будет поддерживаться только поведение, аналогичное использованию ключевого слова TOOLBAR. Необходимо будет удалить явное указание типа окна.

    Тип создаваемого окна. Задается одним из ключевых слов: TOOLBAR, PANEL, TREE или MENU.

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

  • HIDETITLE

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

  • HIDESCROLLBARS

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

  • DRAWROOT

    warning

    Опция объявлена устаревшей. В будущих версиях платформы она не будет поддерживаться.

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

  • orientationType

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

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

    Опция имеет смысл только для окон типа TOOLBAR или PANEL.

  • POSITION(x, y, width, height)

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

    • x

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

    • y

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

    • width

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

    • height

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

  • fixedPositionType

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

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

  • HALIGN(alignType)

    Указание горизонтального выравнивания кнопок в вертикальном тулбаре. Опция имеет смысл только для окон типа TOOLBAR с ориентацией VERTICAL.

    • alignType

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

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

  • VALIGN(alignType)

    Указание вертикального выравнивания кнопок в горизонтальном тулбаре. Опция имеет смысл только для окон типа TOOLBAR с ориентацией HORIZONTAL.

    • alignType

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

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

  • TEXTHALIGN(alignType)

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

    • alignType

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

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

  • TEXTVALIGN(alignType)

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

    • alignType

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

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

Примеры​

// cоздание системных окон в модуле System
WINDOW root 'Корень' TOOLBAR HORIZONTAL POSITION(0, 0, 100, 6) VALIGN(CENTER) HIDETITLE HIDESCROLLBARS;
WINDOW toolbar 'Тулбар' TOOLBAR VERTICAL POSITION(0, 6, 20, 64) HIDETITLE;
WINDOW tree 'Дерево' TOOLBAR POSITION(0, 6, 20, 64) HIDETITLE;

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