Возникает в момент нажатия кнопки выбора или клавиши F4.
Синтаксис
НачалоВыбора(<СтандартнаяОбработка>)Полное описание, параметры и ограничения
ПолеВвода.НачалоВыбора (TextBox.StartChoice)
ПолеВвода (TextBox)
НачалоВыбора (StartChoice)
Доступен, начиная с версии 8.0.
Синтаксис:
НачалоВыбора(<СтандартнаяОбработка>)
Параметры:
<СтандартнаяОбработка>
Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет.
Значение по умолчанию: Истина.
Описание:
Возникает в момент нажатия кнопки выбора или клавиши F4.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
НачалоВыбора: собственное поле обычной формы
Заменяем стандартный выбор немодальным окном собственного списка и обрабатываем результат в экспортной процедуре оповещения.
Где и как запускать
Модуль обычной формы собственной внешней обработки, толстый клиент. Вариант подготовлен отдельно для указанного события.
Подготовка
Создайте собственную внешнюю обработку с обычной формой. Запускайте в толстом клиенте, не в тонком клиенте управляемого приложения.
Реквизиты формы: Наименование (Строка 100), Количество (Число 10.0), Цена (Число 12.2), Сумма (Число 12.2). Элемент ПолеУрока — ПолеВвода, основной обработчик назначьте его событию НачалоВыбора.
Поле для суммы выведите только для просмотра. В числовых опытах цена 100; при количестве 3 сумма 300. Имена реквизитов и элемента различаются намеренно.
Основной код и дополнительные блоки — отдельные процедуры модуля обычной формы. Директивы &НаКлиенте / &НаСервере не добавляются.
Дополнительную ПриОткрытии назначьте событию самой формы. Повторный опыт проводите в новом экземпляре формы, чтобы начальные данные были известны.
Процедура ПолеУрокаНачалоВыбора(Элемент, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Варианты = Новый СписокЗначений;
Варианты.Добавить("Книга");
Варианты.Добавить("Ручка");
Завершение = Новый ОписаниеОповещения("ПослеВыбораКниги", ЭтаФорма);
Варианты.ПоказатьВыборЭлемента(Завершение, "Выберите собственный товар");
Сообщить("Открыт выбор из двух собственных вариантов");
КонецПроцедурыНазначить событию обычной формы ПриОткрытии
Процедура ПриОткрытии()
Наименование = "Книга";
Количество = 3;
Цена = 100;
Сумма = Количество * Цена;
ЭлементыФормы.ПолеУрока.Данные = "Наименование";
ЭлементыФормы.ПолеУрока.КнопкаВыбора = Истина;
КонецПроцедурыТот же модуль обычной формы: экспортное завершение немодального выбора
Процедура ПослеВыбораКниги(ВыбранныйЭлемент, ДополнительныеПараметры) Экспорт
Если ВыбранныйЭлемент = Неопределено Тогда
Возврат;
КонецЕсли;
Наименование = ВыбранныйЭлемент.Значение;
Сообщить("Выбрано: " + Наименование);
КонецПроцедурыРазбор по шагам
Подготавливаем реальное поле ПолеУрока и реквизит соответствующего этому опыту типа.
Платформа вызывает обработчик по указанному действию пользователя; параметры после Элемент взяты из справки.
Заменяем стандартный выбор немодальным окном собственного списка и обрабатываем результат в экспортной процедуре оповещения.
Как проверить результат
F4 / кнопка выбора открывает Книга и Ручка; выбор меняет Наименование.
При отмене существующее имя сохраняется; результат не берётся сразу после открытия диалога.
Ожидаемый результат
Показана реальная обработка ввода в собственном поле обычной формы.
На что обратить внимание
Поле ввода строки, числа и ссылки — разные варианты подготовки; не оставляйте несовместимый тип реквизита.
Не вызывайте процедуры событий вручную вместо проверки пользовательского действия.
Пример не изменяет рабочие документы; вся используемая номенклатура создаётся как собственные учебные метаданные.
ПриИзменении не является универсальной подпиской на любое программное присваивание.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.