Опции действия
При объявлении действия в инструкции ACTION
в конце объявления может указываться некоторый набор опций действия.
Синтаксис
Опции перечисляются друг за другом в произвольном порядке через пробел или переводы строк:
propertyOption1 ... propertyOptionN
Поддерживается следующий набор опций (синтаксис каждой опции указывается в отдельной строке):
IN groupName
viewType
ON eventType { actionOperator }
CHANGEKEY key [SHOW | HIDE]
ASON eventType [ACTION] propertyId
IMAGE path
CONFIRM
Описание и параметры
IN groupName
Указание группы свойств и действий, к которой принадлежит действие. Если опция не указывается, то действие по умолчанию будет принадлежать группе
System.private
.groupName
Имя группы. Составной идентификатор.
Блок интерактивного представления
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
.