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

Опции действия

При объявлении действия в инструкции ACTION в конце объявления может указываться некоторый набор опций действия.

Синтаксис

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

propertyOption1 ... propertyOptionN

Поддерживается следующий набор опций (синтаксис каждой опции указывается в отдельной строке):

IN groupName
viewType
ON eventType { actionOperator }
CHANGEKEY key [SHOW | HIDE]
ASON eventType [ACTION] propertyId
IMAGE path
CONFIRM

Описание и параметры

Блок интерактивного представления

  • viewType

    Указание типа представления действия при добавлении на форму.

    • GRID - колонка таблицы
    • TOOLBAR - тулбар
    • PANEL - панель

    По действию аналогично указанию опции viewType в блоке свойств инструкции FORM. Соответственно, если эта опция не указана ни в опциях действий, ни в блоке свойств непосредственно на форме, используется тип представления по умолчанию для группы отображения, добавляемого на форму действия.

  • ON eventType { actionOperator }

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

    • eventType

      Тип события формы, задается одним из следующих ключевых слов:

      • CHANGE - попытка изменения значения указанного свойства
      • CHANGEWYS - попытка изменения значения указанного свойства с помощью специального механизма ввода. Подробнее можно прочитать в описании событий формы
      • GROUPCHANGE - попытка изменения значения свойства для всех объектов в таблице (групповое редактирование)
      • EDIT - попытка редактирования объекта, который является значением указанного свойства
      • CONTEXTMENU [caption] - пользователь выбрал в контекстном меню свойства на форме заданный пункт. Также при необходимости можно задать заголовок этого пункта меню (строковый литерал). Если этого не сделать, то, по умолчанию, он будет равен заголовку действия.
    • actionOperator

      Контекстно-зависимый оператор-действие. Оператор, описывающий выполняемое по событию действие. В качестве параметров оператора можно использовать параметры самого свойства.

  • ASON eventType [ACTION] propertyId

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

    • eventType

      Аналогично блоку ON.

    • propertyId

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

    • ACTION

      Ключевое слово. Если задано, то считается, что в propertyId задается действие. Если не задано, первоначально считается, что в propertyId задается свойство, и только если оно не найдено, что в propertyId задается действие.

  • IMAGE path

    Указание файла с картинкой, которая будет отображаться в качестве иконки для действия.

    • path

      Относительный путь к файлу. Строковый литерал. Путь указывается относительно каталога images.

Блок значений по умолчанию инструкции DESIGN

  • CHANGEKEY key [SHOW | HIDE]

    Указание комбинации клавиш, при нажатии которой будет выполнено это действие. Устанавливает значение для дизайна по умолчанию, может быть переопределено в инструкции DESIGN.

    • key

      Строковый литерал, описывающий комбинацию клавиш. Принцип задания аналогичен способу задания параметра в методе Java-класса Keystroke.getKeystroke(String).

    • SHOW

      Ключевое слово, при указании которого комбинация клавиш будет отображаться в заголовке действия. Используется по умолчанию.

    • HIDE

      Ключевое слово, при указании которого комбинация клавиш не будет отображаться в заголовке действия.

  • CONFIRM

    Ключевое слово. Если указано, то при запуске действия будет задан вопрос о подтверждении запуска. Устанавливает значение для дизайна по умолчанию, может быть переопределено в инструкции DESIGN.