5.5.2.1.47. TwinColumn
Компонент TwinColumn
представляет собой сдвоенный список для множественного выбора опций. В левом списке содержатся доступные невыбранные значения, в правом списке содержатся выбранные значения. Пользователь выбирает значения, перенося их из левого в правый список и обратно с помощью двойного клика или соответствующих кнопок. Для каждого значения можно задать уникальный стиль отображения и значок.
XML-имя компонента: twinColumn
Компонент реализован только для блока Web Client.
Пример использования компонента twinColumn
для выбора экземпляров сущности:
<dsContext>
<datasource id="carDs" class="com.company.sample.entity.Car" view="_local"/>
<collectionDatasource id="coloursDs" class="com.company.sample.entity.Colour" view="_local">
<query>select c from sample$Colour c</query>
</collectionDatasource>
</dsContext>
<layout>
<twinColumn id="coloursField" optionsDatasource="coloursDs" addAllBtnEnabled="true"/>
В данном случае компонент coloursField
отобразит имена экземпляров сущности Colour
, находящихся в источнике данных coloursDs
, а его метод getValue()
вернет коллекцию выбранных экземпляров сущности.
Атрибут addAllBtnEnabled
задает отображение кнопок, позволяющих перемещать между списками все опции сразу.
Атрибут columns
используется для задания количества символов в строке, а атрибут rows
− для задания количества строк текста в каждом списке.
Для задания внешнего вида опций можно реализовать интерфейс TwinColumn.StyleProvider
и возвращать название стиля и путь к значку в зависимости от конкретного экземпляра сущности, отображаемого в компоненте.
Список опций компонента TwinColumn
может быть задан произвольно с помощью методов setOptionsList()
, setOptionsMap()
и setOptionsEnum()
, аналогично описанному для компонента OptionsGroup.
- Атрибуты twinColumn
-
align - addAllBtnEnabled - caption - captionProperty - columns - contextHelpText - contextHelpTextHtmlEnabled - datasource - description - editable - enable - height - icon - id - leftColumnCaption - optionsDatasource - property - required - requiredMessage - rightColumnCaption - rows - stylename - tabIndex - visible - width
- Элементы twinColumn
- API