Тип: ТипПоведенияКлавишиEnter. Определяет поведение при нажатии на клавишу Enter.
Полное описание, параметры и ограничения
ФормаКлиентскогоПриложения.ПоведениеКлавишиEnter (ClientApplicationForm.EnterKeyBehavior)
ФормаКлиентскогоПриложения (ClientApplicationForm)
ПоведениеКлавишиEnter (EnterKeyBehavior)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: ТипПоведенияКлавишиEnter.
Определяет поведение при нажатии на клавишу Enter.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Назначить фокус полю и отличить Enter от расчёта
Сочетание клавиш поля переводит фокус, а собственная кнопка выполняет расчёт. Активизация уже открытой формы не открывает вторую форму.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.
В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.
Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.
Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.
Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.
Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.
Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = 3;
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Количество собственных книг";
Поле.АктивизироватьПоУмолчанию = Истина;
Поле.СочетаниеКлавиш = Новый СочетаниеКлавиш(Клавиша.F7, Ложь, Истина, Истина);
ЭтаФорма.ПоведениеКлавишиEnter = ТипПоведенияКлавишиEnter.ПереходПоЭлементамФормы;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
ВызватьИсключение "Собственное количество должно быть числом";
КонецЕсли;
Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
ВызватьИсключение "Для учебного расчёта выберите целое количество от 1 до 10";
КонецЕсли;
Цена = 250;
Сумма = ЗначениеПримера * Цена;
Сообщить(Сумма >= 250 И Сумма <= 2500);
Сообщить(Сумма / Цена = ЗначениеПримера);
Сообщить(СтрШаблон("Собственные книги: %1 × %2 = %3", ЗначениеПримера, Цена, Сумма));
Если ЭтаФорма.Открыта() Тогда
ЭтаФорма.Активизировать();
ЭтаФорма.ТекущийЭлемент = Элементы.ПолеПримера;
КонецЕсли;
Сообщить(Элементы.ПолеПримера.СочетаниеКлавиш.Клавиша = Клавиша.F7);
Сообщить(Элементы.ПолеПримера.СочетаниеКлавиш.Ctrl И Элементы.ПолеПримера.СочетаниеКлавиш.Shift);
Сообщить("Ввод доступен в собственной форме сейчас: " + Строка(ЭтаФорма.ВводДоступен()));
КонецПроцедуры
Разбор по шагам
АктивизироватьПоУмолчанию назначаем своему полю при серверном создании. Начальное количество равно 3, но фокус не вычисляет сумму сам.
Конструктор сочетания принимает F7, Alt = Ложь, Control = Истина и Shift = Истина именно в таком порядке.
Поведение Enter — ПереходПоЭлементамФормы. Это не назначение команды расчёта клавише Enter.
Кнопка считает сумму, затем активизирует уже открытую собственную форму и устанавливает её ТекущийЭлемент.
Комбинация Ctrl+Shift+F7 должна переводить фокус к полю; после изменения количества снова нажимайте кнопку для нового расчёта.
Как проверить результат
При исходном 3 ожидаются четыре Истина и 750. После ввода 5 — 1250; реквизит не сбрасывается при активизации.
Проверьте Tab, Enter и Ctrl+Shift+F7 в выбранном клиенте. ВводДоступен выводится как фактический признак, а не обещание фокуса во всех окружениях.
Ожидаемый результат
Разведены начальный фокус, горячая клавиша поля, переход по Enter и команда вычисления.
На что обратить внимание
В мобильной платформе АктивизироватьПоУмолчанию не начинает интерактивное редактирование: это отдельный контракт.
Сочетание клавиш поля и сочетание команды не одно и то же; в этом уроке оно назначено именно полю.
Открыта не доказывает, что окно сейчас активно. Активизировать применяется к уже открытой форме, не заменяет Открыть.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.