Асинхронная функция. Позволяет интерактивно выбрать один из элементов, входящих в список значений.
Синтаксис
ВыбратьЭлементАсинх(<Заголовок>, <Элемент>)Полное описание, параметры и ограничения
СписокЗначений.ВыбратьЭлементАсинх (ValueList.ChooseItemAsync)
СписокЗначений (ValueList)
ВыбратьЭлементАсинх (ChooseItemAsync)
Доступен, начиная с версии 8.3.18.
Синтаксис:
ВыбратьЭлементАсинх(<Заголовок>, <Элемент>)
Параметры:
<Заголовок> (необязательный)
Тип: Строка.
Заголовок окна выбора. Если параметр не указан, то используется стандартный заголовок.
Значение по умолчанию: Пустая строка.
<Элемент> (необязательный)
Тип: ЭлементСпискаЗначений.
Элемент, на который следует изначально спозиционировать список значений при интерактивном выборе. Если значением параметра не является элемент списка значений, входящий в данный список, позиционирования не произойдет.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - выбранный элемент, и Неопределено, если пользователь отказался от выбора.
Описание:
Асинхронная функция. Позволяет интерактивно выбрать один из элементов, входящих в список значений.
Доступность:
Тонкий клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).
См. также:
СписокЗначений, метод ВыбратьЭлемент
СписокЗначений, метод ПоказатьВыборЭлемента
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Выбрать доставку через Ждать и сохранить старый код при отмене
Полная управляемая форма с исходным pickup. Диалог возвращает элемент или Неопределено, а не код напрямую.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Строка");
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = "pickup";
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Выбранные учебные коды";
Поле.ТолькоПросмотр = Истина;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выбрать один способ";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Асинх Процедура УчебноеДействие(Команда)
Способы = УчебныеСпособыДоставки();
Начальный = Способы.НайтиПоЗначению(ЗначениеПримера);
Элементы.КнопкаУчебноеДействие.Доступность = Ложь;
Попытка
Выбранный = Ждать Способы.ВыбратьЭлементАсинх("Учебная доставка", Начальный);
Исключение
Элементы.КнопкаУчебноеДействие.Доступность = Истина;
ВызватьИсключение;
КонецПопытки;
Элементы.КнопкаУчебноеДействие.Доступность = Истина;
Если Выбранный = Неопределено Тогда
Сообщить("Отмена: прежний учебный код сохранён.");
Возврат;
КонецЕсли;
ЗначениеПримера = Выбранный.Значение;
Сообщить("Выбрано: " + Выбранный.Представление);
Сообщить("Хранимый код: " + ЗначениеПримера);
КонецПроцедуры
&НаКлиенте
Функция УчебныеСпособыДоставки()
Способы = Новый СписокЗначений;
Способы.Добавить("pickup", "Самовывоз");
Способы.Добавить("courier", "Курьер");
Способы.Добавить("post", "Почта");
Возврат Способы;
КонецФункции
Разбор по шагам
Список создаётся на клиенте из трёх известных кодов; начальное позиционирование ищем по текущему коду поля.
Асинх Процедура позволяет Ждать результат обещания. Кнопка временно недоступна для повторного вызова.
При исключении кнопка восстанавливается; при обычном закрытии — тоже.
Неопределено означает отмену. Никаких свойств у него не читаем, поле не изменяем.
У выбранного элемента берём Значение для хранения, Представление — только для сообщения.
Как проверить результат
Выберите Курьер: поле courier, сообщение Курьер.
Повторно нажмите и отмените: courier остаётся.
После закрытия диалога кнопка снова доступна.
Ожидаемый результат
Рабочий учебный выбор одного значения с отменой, позиционированием и защитой от повторного нажатия.
На что обратить внимание
Старый синхронный ВыбратьЭлемент отличается от асинхронного API и может быть запрещён настройками модальности.
Возвращается ЭлементСпискаЗначений, не Строка и не Булево.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.