5.5.4.2.2. Стандартные действия поля выбора
Для компонентов PickerField, LookupPickerField и SearchPickerField набор стандартных действий определен в перечислении PickerField.ActionType
. Реализации являются внутренними классами интерфейса PickerField
.
Пример использования стандартных действий в компоненте выбора:
<searchPickerField optionsDatasource="coloursDs"
datasource="carDs" property="colour">
<actions>
<action id="clear"/>
<action id="lookup"/>
<action id="open"/>
</actions>
</searchPickerField>
LookupAction
LookupAction
- действие с идентификатором lookup. Предназначено для выбора экземпляра сущности и установки его в качестве значения компонента. При срабатывании открывает экран выбора сущностей.
В классе LookupAction
определены следующие специфические методы:
-
setLookupScreenOpenType()
- позволяет задать режим открытия экрана выбора сущности. По умолчанию экран открывается в режимеTHIS_TAB
. -
setLookupScreen()
- позволяет задать идентификатор экрана выбора сущности. По умолчанию используется экран{имя_сущности}.lookup
, напримерsales$Customer.lookup
. Если такого экрана не существует, то делается попытка открыть экран{имя_сущности}.browse
, напримерsales$Customer.browse
. -
setLookupScreenParams()
- позволяет задать параметры экрана выбора, передаваемые в его методinit()
. -
afterSelect()
- вызывается действием после того, как выбранный экземпляр установлен в качестве значения компонента. Данный метод не имеет реализации и может быть переопределен в наследниках для реакции на это событие. -
afterCloseLookup()
- вызывается действием в последнюю очередь после закрытия экрана выбора, независимо от того, был сделан выбор или нет. Данный метод не имеет реализации и может быть переопределен в наследниках для реакции на это событие.
ClearAction
ClearAction
- действие с идентификатором clear. Предназначено для очистки (то есть установки в null
) текущего значения компонента.
OpenAction
OpenAction
- действие с идентификатором open. Предназначено для открытия экрана редактирования экземпляра сущности, являющегося текущим значением компонента.
В классе OpenAction
определены следующие специфические методы:
-
setEditScreenOpenType()
- позволяет задать режим открытия экрана редактирования сущности. По умолчанию экран открывается в режимеTHIS_TAB
. -
setEditScreen()
- позволяет задать идентификатор экрана редактирования сущности. По умолчанию используется экран{имя_сущности}.edit
, напримерsales$Customer.edit
. -
setEditScreenParams()
- позволяет задать параметры экрана редактирования, передаваемые в его методinit()
. -
afterWindowClosed()
- вызывается действием после закрытия экрана редактирования. Данный метод не имеет реализации и может быть переопределен в наследниках для реакции на это событие.