Расширение поля формы для поля ввода.ОбработкаВыбора (Form field extension for a text box.ChoiceProcessing)
Расширение поля формы для поля ввода (Form field extension for a text box)
ОбработкаВыбора (ChoiceProcessing)
Доступен, начиная с версии 8.2.
Синтаксис:
ОбработкаВыбора(<ВыбранноеЗначение>, <ДополнительныеДанные>, <ВыборДобавлением>, <СтандартнаяОбработка>)Параметры:
<ВыбранноеЗначение>
Выбранное значение, которое будет установлено как значения поля ввода или массив выбранных значений в случае, если в подчиненной форме свойство МножественныйВыбор имеет значение Истина.
В параметре можно вернуть другое значение, которое и будет помещено в элемент управления.
Выбранное значение будет помещаться в историю выбора поля ввода формы клиентского приложения.
<ДополнительныеДанные>
Дополнительные данные, переданные в обработчике при заполнении данных выбора. Если выбор или подбор произведен из формы выбора, в этот параметр передается Неопределено.
<ВыборДобавлением>
Если событие вызвано с помощью метода ОповеститьОВыборе, параметр получает фактическое значение параметра <ВыборДобавлением>, вызвавшего событие метода.
Если событие вызвано интерактивным выбором в форме выбора, параметр события принимает значение параметра формы <ВыборДобавлением>.
В остальных случаях:
- Истина — если поле ввода в режиме расширенного редактирования множественных значений,
- Ложь — если поле ввода в режиме ввода единичного значения,
В режиме расширенного редактирования множественных значений:
- Когда поле ввода редактирует СписокЗначений и <ЗначениеВыбора> имеет тип СписокЗначений:
- Если параметр <ВыборДобавлением> имеет значение Ложь, тогда <ЗначениеВыбора> заменяет значения редактируемого реквизита и вызывается событие ПриИзменении,
- В противном случае вызывается событие ДобавлениеМножественныхЗначений, <ЗначениеВыбора> приводится к типу множественного значения и добавляется в список значений, вызывается событие ПриИзменении;
- Когда <ЗначениеВыбора> имеет тип Массив:
- Если параметр <ВыборДобавлением> имеет значение Ложь, список текущих множественных значений очищается,
- Вызывается событие ДобавлениеМножественныхЗначений,
- Добавляются новые значения из массива,
- Вызывается событие ПриИзменении,
- В других случаях:
- Если параметр <ВыборДобавлением> имеет значение Ложь, список текущих множественных значений очищается,
- Вызывается событие ДобавлениеМножественныхЗначений,
- Добавляется новое значение <ЗначениеВыбора>,
- Вызывается событие ПриИзменении.
<СтандартнаяОбработка>
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:
Вызывается после осуществления выбора, но до помещения выбранного значения в элемент управления.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент).
Примечание:
В обработчике данного события нельзя использовать серверные методы формы с директивой компиляции &НаСервере, а также изменять свойства, которые могут привести к серверному вызову.Использование в версии:
Доступен, начиная с версии 8.2.
Описание изменено в версии 8.3.23.