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