BaseDataSource.setSelectedItem()¶
Устанавливает выделенный элемент.
Description¶
В каждый момент времени пользователь может работать только с одним элементом - выделенным элементом. Зачастую это элемент, на котором установлен фокус ввода. Например, редактируемый элемент, выбранный элемент в списке и т.д. Источник данных хранит информацию о выделенном элементе, благодаря чему имеется возможность определять элемент данных, с которым работает пользователь. Изменение выделенного элемента приводит к возникновению события onSelectedItemChanged.
Syntax¶
BaseDataSource.setSelectedItem(item, success, error)
Parameters¶
| Name | Description |
|---|---|
| item* | Элемент источника данных |
| success | Обработчик события о том, что выделенный элемент изменился. Параметр args данного обработчика содержит поле source, в котором хранится ссылка на источник данных |
| error | Обработчик события о том, что при изменении выделенного элемента произошла ошибка. Параметр args данного обработчика содержит поле error, хранящее сообщение об ошибке |
* Обязательный аргумент.
Returns¶
Метод ничего не возвращает.
Examples¶
var items = BaseDataSource.getItems();
BaseDataSource.setSelectedItem(items[0]);