Другое · 8 мин
Установка фокуса на элемент формы в 1С
Пошаговая инструкция по установке фокуса на реквизит или команду формы в 1С: управляемые формы, клиентские методы и проверка результата в конфигурации.
В управляемых формах 1С фокус означает активный элемент, который получает ввод с клавиатуры после открытия формы или срабатывания обработчика. Программно управлять фокусом нужно, когда пользователю важно сразу начать заполнять определённый реквизит, например после ошибки проверки или при открытии справочника в режиме создания.
Основной инструмент — метод УстановитьФокус у элемента формы. Он работает на стороне клиента и применим к полям ввода, командам, кнопкам и ячейкам табличной части. Вызов должен выполняться после того, как форма уже отображена, иначе платформа проигнорирует попытку переместить курсор.
Не каждый элемент может получить фокус. Доступность зависит от свойств Видимость, Доступность, режима редактирования и состояния формы. Если элемент скрыт или заблокирован, установка фокуса не приведёт к видимому результату, а в некоторых случаях может вызвать исключение при некорректной ссылке на элемент.
Когда программная установка фокуса оправдана
Самый частый сценарий — возврат пользователя к реквизиту, который не прошёл проверку заполнения. После сообщения об ошибке форма остаётся открытой, и курсор удобно переместить прямо на проблемное поле, чтобы пользователь не искал его вручную.
Ещё один вариант — открытие формы в режиме создания нового объекта. Можно сфокусировать основной реквизит, например наименование или код, чтобы сразу начать ввод без лишних кликов мышью. Это ускоряет работу при массовом заполнении справочников или документов.
Установка фокуса полезна и после завершения действия, когда нужно вернуть внимание пользователя к ключевому полю. Например, после выбора значения из справочника через форму выбора можно перефокусировать поле ввода, в которое должен подставиться результат.
Как установить фокус на реквизит формы
Для обычного поля формы обращайтесь к элементу через коллекцию Элементы и вызывайте у него метод УстановитьФокус. Типичная запись в модуле формы клиентского приложения выглядит так: Элементы.МойРеквизит.УстановитьФокус();. Имя элемента должно совпадать с именем реквизита или элемента управления в редакторе формы.
Вызов размещайте в обработчиках, которые выполняются после отрисовки формы: ПриОткрытии, ПриАктивности или после завершения проверки. Если поставить фокус в процедуре, которая ещё не завершила открытие формы, элемент может быть недоступен для фокусировки.
Перед вызовом целесообразно проверить, что форма не модальна в ограничивающем смысле, элемент не скрыт и доступен для редактирования. Если форма открывается в отдельном окне, фокус устанавливается в контексте этого окна, а не всей системы.
Уточнение для команд и кнопок
Команды формы тоже могут получать фокус, но поведение зависит от способа отображения команды: на панели команд, в подменю или как кнопка на форме. Для кнопки на панели формы достаточно ссылки на соответствующий элемент управления, а для команды — проверить, что она отображается в текущем контексте и не недоступна из-за прав или условий видимости.
Если команда представлена как действие в меню, прямое программное выделение может быть ограничено платформой. В таких случаях проще сфокусировать ближайшее доступное поле ввода рядом с командой, чем пытаться установить фокус на саму команду.
Табличная часть и текущая строка
Для табличной части фокус обычно означает не только колонку, но и строку. Нужно установить текущую строку таблицы, а затем сфокусировать нужную ячейку или реквизит строки. Обращение к табличной части выполняется через Элементы.ИмяТабличнойЧасти, а текущие данные берутся из свойств формы или объекта.
Если таблица пустая, фокус на конкретную ячейку установить невозможно, потому что нет строки. Сначала нужно добавить строку или дождаться загрузки данных, а затем перемещать курсор по нужной колонке.
При работе с табличными частями учитывайте режим редактирования. В режиме просмотра фокус может перемещаться ограниченно, а в режиме редактирования доступен прямой ввод в ячейку. Проверка режима помогает избежать ситуации, когда фокус формально установлен, но ввод заблокирован.
- 1Откройте модуль формы на стороне клиента
- 2Найдите нужный элемент через коллекцию Элементы
- 3Убедитесь, что форма отображена и элемент доступен
- 4Вызовите метод УстановитьФокус у этого элемента
- 5Проверьте визуально, что курсор переместился
Ограничения и проверка результата
Метод УстановитьФокус не гарантирует, что пользователь увидит курсор, если элемент находится за пределами видимой области формы. Платформа может не прокручивать форму автоматически к скрытому полю. В таких случаях полезно предварительно сделать элемент видимым или открыть вкладку, на которой он расположен.
Нельзя установить фокус на элемент, который находится в группе с ограниченной доступностью, или на реквизит, для которого отключено редактирование на основании прав доступа. Также не стоит пытаться переместить фокус на элемент другой формы или закрытого окна.
Результат проверяется визуально: активное поле должно иметь рамку фокуса и готовиться к вводу. Если после вызова курсор остался на предыдущем элементе, причина может быть в недоступности целевого поля, ошибке в имени элемента или слишком раннем моменте вызова.
Частые ошибки и способы их устранения
Ошибка в имени элемента приводит к тому, что ссылка Элементы.Имя не находится, и метод не вызывается. Имя в коде должно точно совпадать с именем в редакторе формы, включая регистр, если платформа чувствительна к нему в данном контексте.
Вызов УстановитьФокус до полного открытия формы часто игнорируется. Перенесите код в обработчик ПриОткрытии или с небольшой задержкой после инициализации, чтобы элементы уже были созданы на клиенте.
Попытка сфокусировать скрытый или недоступный элемент не даёт эффекта. Проверьте свойства Видимость и Доступность, а также права пользователя. Если поле заблокировано условием, сначала снимите блокировку или выберите другое поле для фокуса.
Как выбрать действие
Как выбрать подходящий способ
Если нужно сфокусировать обычное поле, используйте прямой вызов у элемента формы. Для команд и кнопок сначала проверьте их видимость и доступность в текущей панели. Для табличных частей определите текущую строку, а затем колонку.
Если несколько элементов могут претендовать на фокус, отдавайте приоритет полю, которое пользователь должен заполнить первым, или полю с ошибкой валидации. Не перемещайте фокус автоматически слишком часто, это может раздражать и нарушать привычную последовательность ввода.
Как проверить результат
Поле готово к вводу с клавиатуры
Курсор остался на предыдущем элементе
Редактирование разрешено
Поле скрыто, заблокировано или недоступно
Как проверить, что фокус установлен корректно
Откройте форму в обычном режиме работы и выполните действие, после которого должен сработать фокус. Курсор должен переместиться на целевое поле, и клавиатурный ввод должен поступать именно туда. Если фокус остался на другом элементе, проверьте доступность целевого поля и момент вызова метода.
Повторите проверку с разными правами доступа и разными режимами формы: создание, редактирование, просмотр. Некоторые поля могут быть доступны только в определённых режимах, и поведение фокуса изменится соответственно.
Что важно запомнить
Фокус в 1С устанавливается клиентским методом у видимого и доступного элемента после открытия формы; результат проверяется визуально и в разных режимах работы.
Можно ли установить фокус на скрытое поле?
Нет, скрытый элемент не может стать активным для ввода. Сначала сделайте поле видимым через свойство формы или условие отображения, а затем вызывайте УстановитьФокус.
Работает ли установка фокуса из серверного модуля?
Нет, прямое управление фокусом формы пользователя относится к клиентской части. Серверный код может подготовить данные или флаг, а клиентский обработчик уже должен выполнить перемещение курсора.
Что делать, если фокус не перемещается после вызова?
Проверьте имя элемента, момент вызова, доступность и видимость поля, а также режим редактирования формы. Часто причина в слишком раннем вызове до отрисовки формы или в блокировке элемента правами доступа.
Нужно ли фокусировать табличную часть иначе, чем обычное поле?
Да, для табличной части важно сначала задать текущую строку, а затем сфокусировать нужную ячейку или колонку. В пустой таблице без строк фокус на конкретную ячейку установить нельзя.