Возникает в момент нажатия кнопки выбора из списка.
Синтаксис
НачалоВыбораИзСписка(<СтандартнаяОбработка>)Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.НачалоВыбораИзСписка (Form field extension for a text box.StartListChoice)
Расширение поля формы для поля ввода (Form field extension for a text box)
НачалоВыбораИзСписка (StartListChoice)
Не рекомендуется использовать, начиная с версии 8.3.2.
Рекомендуется использовать:
ПриСозданииНаСервере
Доступен, начиная с версии 8.2 (в режиме совместимости с версией 8.3.2 и последующими).
Синтаксис:
НачалоВыбораИзСписка(<СтандартнаяОбработка>)
Параметры:
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:
Возникает в момент нажатия кнопки выбора из списка.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент).
Примечание:
В обработчике данного события нельзя использовать серверные методы формы с директивой компиляции &НаСервере, а также изменять свойства, которые могут привести к серверному вызову.
Использование в версии:
Доступен, начиная с версии 8.2 (в режиме совместимости с версией 8.3.2 и последующими).
Не рекомендуется использовать, начиная с версии 8.3.2.
Описание изменено в версии 8.3.15.
Методическая информация
Практические примеры
Разобрать событие «НачалоВыбораИзСписка» на собственном элементе
Подготавливаем конкретную свою форму и вызываем событие обычным пользовательским действием. Основной блок — настоящий обработчик, а не прямой ручной вызов события.
Где и как запускать
Клиентский обработчик собственной управляемой формы; подготовка данных отдельно в ПриСозданииНаСервере.
Подготовка
Создайте внешнюю обработку с собственной управляемой формой, запуск — тонкий клиент, если ниже не указан другой клиент.
Добавьте СчетчикСобытий (Число 10.0) и СтатусУрока (Строка 200), выведите оба на форму. Дополнительный блок инициализации поместите в модуль этой же формы.
Основной обработчик назначьте через свойства нужного элемента → События. Параметр Элемент добавляется обработчику события элемента формы; у события самой формы его нет. Не создавайте вторую процедуру с тем же именем.
Добавьте Комментарий типа Строка 100 и поле ввода Комментарий. Собственный список из двух строк заполняется до показа формы.
Для проверки нажмите кнопку выбора из списка и выберите собственное название. Редактирование одной строки, не множественный ввод.
Это устаревшее событие для чтения / сопровождения старого кода. Список уже подготовлен в ПриСозданииНаСервере — именно этот способ рекомендуется для нового кода. Не меняйте режим совместимости ради урока.
&НаКлиенте
Процедура КомментарийНачалоВыбораИзСписка(Элемент, СтандартнаяОбработка)
СчетчикСобытий = СчетчикСобытий + 1;
СтатусУрока = "Открывается собственный список: " + Строка(СчетчикСобытий);
Сообщить(СтатусУрока);
КонецПроцедурыТа же собственная форма: подготовка до интерактивного действия
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
СчетчикСобытий = 0;
СтатусУрока = "Ожидается действие пользователя";
Комментарий = "";
Элементы.Комментарий.РежимВыбораИзСписка = Истина;
Элементы.Комментарий.КнопкаСпискаВыбора = Истина;
Элементы.Комментарий.СписокВыбора.Добавить(" Учебная книга ");
Элементы.Комментарий.СписокВыбора.Добавить("Учебная тетрадь");
КонецПроцедурыРазбор по шагам
Разместите указанный элемент и отдельный инициализатор в правильном модуле.
Назначьте обработчик через свойства события и выполните указанное пользовательское действие.
Посмотрите собственный статус / результат; не путайте событие с похожими соседними событиями.
Как проверить результат
В среде, где событие поддерживается, открытие списка увеличивает счётчик, не отменяя стандартный выбор.
Если обработчик в текущем режиме не вызывается, список всё равно подготовлен рекомендуемым способом; успешный вызов устаревшего события не обещается.
Ожидаемый результат
Событие связано с реальным источником, известными собственными данными и воспроизводимым действием.
На что обратить внимание
События выбора запрещают серверные методы формы и свойства, вызывающие сервер. Список заполняется заранее, не в клиентском обработчике.
Не добавляйте Элемент в события самой формы / модуль команды; у событий элементов формы он является контекстным параметром обработчика.
Разные дополнительные блоки относятся к явно названным модулям; одинаковые процедуры инициализации объединяются, а не дублируются.
Код 1С при сборке справочника не исполнялся; сеть, рабочие записи, печать и внешние компоненты не использовались.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.