Чекбокс в 1С: полное руководство по использованию флажка в конфигурациях

В системе 1С:Предприятие элемент управления чекбокс (или флажок) — один из базовых инструментов для работы с булевыми значениями (Истина/Ложь). Он позволяет пользователям быстро включать/отключать опции, подтверждать выбор или управлять видимостью других элементов формы. Несмотря на кажущуюся простоту, чекбоксы в 1С 8.3 и 1С 8.2 имеют нюансы настройки, которые влияют на удобство интерфейса и логику работы программы.

Этот элемент часто используется в формах документов, справочниках, отчетах и даже в настройках прав пользователей. Например, флажок "Печатать сразу" в документе РеализацияТоваровУслуг или опция "Показывать удаленные" в списке номенклатуры. Однако многие пользователи и начинающие разработчики не знают, как правильно связать чекбокс с данными, настроить его внешний вид или обработать событие изменения состояния. В этой статье мы разберем все аспекты работы с чекбоксами — от базового добавления на форму до сложных сценариев с триггерами и динамическим управлением.

Что такое чекбокс в 1С и зачем он нужен

Чекбокс (от англ. checkbox — "галочка в квадратике") — это графический элемент интерфейса, который позволяет пользователю включать или отключать опцию одним кликом. В отличие от переключателей (РадиоКнопка), чекбоксы могут работать независимо друг от друга, что позволяет выбирать несколько вариантов одновременно.

В 1С:Предприятие чекбокс представлен объектом ПолеФлажка (в англоязычной версии — CheckBox) и имеет три возможных состояния:

• 🗹 Установлен (Истина) — галочка видна, опция активна.
• □ Снят (Ложь) — галочки нет, опция отключена.
• 🟦 Неопределен (Неопределено) — серый квадратик, используется редко (например, для тристатных флажков в иерархических структурах).

Основные области применения чекбоксов в 1С:

• 📄 Формы документов: подтверждение печатных форм, блокировка редактирования, выбор способа оплаты.
• 📊 Отчеты и обработки: фильтры ("Показывать только актуальные", "Исключать помеченные на удаление").
• 🔧 Настройки программы: включение/отключение функционала (например, "Использовать управленческий учет").
• 👥 Права доступа: назначение ролей или разрешений для пользователей.

⚠️ Внимание: В некоторых конфигурациях (например, 1С:Бухгалтерия 3.0) чекбоксы могут автоматически влиять на видимость других полей формы через механизм УправляемаяФорма.ЭлементыФормы.Видимость. Изменение состояния флажка без проверки связанных событий может привести к ошибкам интерфейса.

Как добавить чекбокс на форму в конфигураторе

Добавление чекбокса на форму в 1С 8.3 осуществляется через Конфигуратор или непосредственно в режиме 1С:Предприятие (для управляемых форм). Рассмотрим оба способа.

Способ 1: Через Конфигуратор (для обычных форм)

1. Откройте конфигурацию в режиме Конфигуратор.
2. Перейдите в ветку Объекты → [ВашОбъект] → Формы (например, Документ.РеализацияТоваровУслуг.ФормаДокумента).
3. Дважды кликните на форму, чтобы открыть ее в редактор.
4. В панели элементов найдите Поле флажка (иконка с галочкой) и перетащите его на форму.
5. В Палитре свойств укажите:
   • 🔹 Имя — уникальный идентификатор (например, ФлажокПечать).
   • 🔹 Заголовок — текст рядом с чекбоксом (например, "Печатать сразу").
   • 🔹 Данные — связь с реквизитом объекта (например, Объект.ПечататьСразу).

Способ 2: В режиме 1С:Предприятие (для управляемых форм)

Для управляемых форм чекбокс добавляется через редактор формы:

1. Откройте форму в режиме 1С:Предприятие (например, документ ПоступлениеТоваров).
2. Нажмите Еще → Изменить форму (или F5 в некоторых конфигурациях).
3. В панели элементов выберите Флажок и разместите его на форме.
4. В свойствах укажите:
   • 🔹 Имя — например, ФлажокБлокироватьЦены.
   • 🔹 ПутьКДанным — связь с реквизитом (например, Объект.БлокироватьЦены).
   • 🔹 Подсказка — текст, который появится при наведении мыши.

Проверьте тип реквизита (должен быть Булево)

Убедитесь, что имя чекбокса уникально на форме

Настройте видимость связанных элементов (если нужно)

Сохраните форму перед тестированием-->

После добавления чекбокса обязательно сохраните форму и перезапустите сеанс, чтобы изменения вступили в силу. Если флажок не отображается или не работает, проверьте:

• 🔧 Правильность указания пути к данным (ПутьКДанным для управляемых форм или Данные для обычных).
• 🔧 Тип реквизита — он должен быть Булево (а не Число или Строка).
• 🔧 Права доступа — пользователь должен иметь права на редактирование этого реквизита.

Связь чекбокса с данными: реквизиты и переменные

Чекбокс в 1С может быть связан с:

1. Реквизитом объекта (например, флажок "Оплачено" в документе ПоступлениеНаличных).
2. Переменной формы (временное значение, не сохраняемое в базе).
3. Параметром отчета (например, "Показывать только остатки" в отчете ВедомостьПоТоварам).

Рассмотрим каждый вариант подробнее.

1. Связь с реквизитом объекта

Если чекбокс должен сохранять свое состояние в базе данных, его необходимо привязать к реквизиту объекта. Например, добавим флажок "Включить скидку" в документ ЗаказКлиента:

// В конфигураторе:
1. Откройте объект "Документ.ЗаказКлиента".
2. Добавьте реквизит "ПрименятьСкидку" типа "Булево".
3. В форме документа добавьте чекбокс и свяжите его с реквизитом:
- Для обычной формы: Данные = Объект.ПрименятьСкидку
- Для управляемой формы: ПутьКДанным = Объект.ПрименятьСкидку

2. Связь с переменной формы

Если флажок нужен только для временных целей (например, для управления отображением элементов), используйте переменную формы:

// В модуле формы:
Перем ФлажокПоказыватьДополнительно;

// В свойствах чекбокса (управляемая форма):
ПутьКДанным = ФлажокПоказыватьДополнительно

3. Связь с параметром отчета

В отчетах чекбоксы часто используются для фильтров. Например, в отчете АнализПродаж можно добавить параметр "ИсключатьВозвраты" типа Булево и связать его с флажком на форме настройки отчета.

Тип связи	Пример использования	Где хранится значение
Реквизит объекта	Флажок "Оплачено" в документе	В базе данных (таблица документа)
Переменная формы	Временный переключатель режимов просмотра	Только в памяти формы
Параметр отчета	Фильтр "Показывать только актуальные"	В параметрах отчета

⚠️ Внимание: Если чекбокс связан с реквизитом объекта, но не сохраняет состояние при записи документа, проверьте процедуру ПередЗаписью() — возможно, там сбрасывается значение флажка. Также убедитесь, что реквизит не помечен как "Несохраняемый" в свойствах объекта.

Обработка событий чекбокса: ПриИзменении и другие

Чекбоксы в 1С могут запускать события, которые позволяют динамически изменять интерфейс или выполнять действия при изменении состояния. Основные события:

• 🔄 ПриИзменении — срабатывает при изменении значения флажка.
• 🖱️ НачалоВыбора / ОкончаниеВыбора — для тонкой настройки взаимодействия.
• 🔍 ПриАктивизацииЭлемента — когда пользователь переходит на чекбокс с клавиатуры.

Самое часто используемое событие — ПриИзменении. Например, можно скрывать или показывать дополнительные поля в зависимости от состояния флажка:

Процедура ФлажокДополнительноПриИзменении(Элемент)
ЭлементыФормы.ПолеДополнительнойИнформации.Видимость = Элемент.Значение;
КонецПроцедуры

Другой пример — автоматическое заполнение реквизитов при установке флажка:

Процедура ФлажокАвтоЗаполнениеПриИзменении(Элемент)
Если Элемент.Значение Тогда
Объект.ДатаОплаты = ТекущаяДата();
Объект.СуммаОплаты = Объект.СуммаДокумента;
Иначе
Объект.ДатаОплаты = '00010101';
Объект.СуммаОплаты = 0;
КонецЕсли;
КонецПроцедуры

Для управляемых форм доступны дополнительные события, такие как ПриИзмененииНаСервере, которое выполняется на сервере и может содержать более сложную логику:

Процедура ФлажокИспользоватьСкидкуПриИзмененииНаСервере(Элемент)
Если Элемент.Значение Тогда
Объект.ПроцентСкидки = ПолучитьМаксимальнуюСкидку(Объект.Контрагент);
КонецЕсли;
КонецПроцедуры

Тристатный чекбокс: когда используется состояние "Неопределено"

В большинстве случаев чекбоксы имеют два состояния: Истина и Ложь. Однако в 1С поддерживается и третье состояние — Неопределено (отображается как серый квадратик). Оно используется в следующих сценариях:

• 📂 Иерархические данные: если в дереве элементов часть дочерних узлов отмечена, а часть — нет, родительский узел может показывать Неопределено.
• 🔄 Групповая обработка: при выборе нескольких строк в таблице, где у одних флажок установлен, а у других — нет.
• 🔧 Настройки по умолчанию: когда значение не задано явно (например, в шаблонах).

Пример использования тристатного чекбокса в справочнике с иерархией:

Процедура ФлажокАктивностьПриИзменении(Элемент)
Если Элемент.Значение = Неопределено Тогда
Сообщить("Выберите значение для всех дочерних элементов!");
Элемент.Значение = Ложь; // Сброс в исходное состояние
Иначе
УстановитьАктивностьДетям(Объект.Ссылка, Элемент.Значение);
КонецЕсли;
КонецПроцедуры

Чтобы включить поддержку тристатного режима, в свойствах чекбокса установите параметр ТриСостояния = Истина. В управляемых формах это свойство называется ТриСостояния, в обычных — ТриСостоянияФлажка.

⚠️ Внимание: Не все конфигурации корректно обрабатывают состояние Неопределено при записи в базу. В некоторых случаях оно может автоматически конвертироваться в Ложь. Перед использованием тристатных чекбоксов проверьте логику сохранения данных в вашей конфигурации.

Никогда не использовал

Редко, только для иерархических справочников

Часто, в групповых обработках

Постоянно, это часть моей типовой логики-->

Динамическое управление чекбоксами: видимость, доступность, цвет

Чекбоксы в 1С можно динамически настраивать в зависимости от условий: скрывать, блокировать или изменять их внешний вид. Это реализуется через свойства элемента формы или программно.

1. Управление видимостью

Чтобы скрыть или показать чекбокс, используйте свойство Видимость:

ЭлементыФормы.ФлажокСкидка.Видимость = (Объект.ТипЦен = Перечисление.ТипыЦен.Оптовая);

2. Блокировка (доступность)

Если чекбокс должен быть виден, но недоступен для изменения:

ЭлементыФормы.ФлажокОплачено.Доступность = Не Объект.Проводится;

3. Изменение цвета и стиля

В управляемых формах можно менять цвет текста или фона чекбокса через свойство ЦветТекста или ЦветФона:

ЭлементыФормы.ФлажокВажно.ЦветТекста = ВебЦвет.Красный;

Для обычных форм стилизация ограничена, но можно использовать УстановитьДействие для изменения внешнего вида при определенных условиях.

Свойство	Пример использования	Тип формы
Видимость	Скрыть флажок для неактивных пользователей	Обычная/Управляемая
Доступность	Заблокировать флажок после проведения документа	Обычная/Управляемая
ЦветТекста	Выделить красным важные опции	Только управляемая
Подсказка	Показать дополнительную информацию при наведении	Обычная/Управляемая

Как изменить размер чекбокса?

В управляемых формах размер чекбокса фиксирован и не настраивается. Для обычных форм можно попробовать изменить свойство ВысотаСтроки у контейнера, в котором размещен флажок, но это может привести к искажению интерфейса. Рекомендуется использовать стандартные размеры.

Типичные ошибки при работе с чекбоксами и как их избежать

Даже опытные разработчики 1С иногда сталкиваются с проблемами при работе с чекбоксами. Вот наиболее распространенные ошибки и способы их решения:

1. Флажок не сохраняет значение

   Причина: реквизит, к которому привязан чекбокс, не включен в состав данных объекта или имеет неправильный тип.

   Решение: проверьте, что реквизит:

   • 🔹 Имеет тип Булево.
   • 🔹 Не помечен как Несохраняемый.
   • 🔹 Включен в состав данных формы (для управляемых форм проверьте свойство ПутьКДанным).
2. Событие ПриИзменении не срабатывает

   Причина: обработчик события не привязан к чекбоксу или содержит ошибки.

   Решение:

   • 🔹 Проверьте имя процедуры — оно должно совпадать с именем элемента + ПриИзменении.
   • 🔹 Убедитесь, что в модуле формы нет опечаток.
   • 🔹 Для управляемых форм проверьте, что событие привязано на клиенте или сервере (в зависимости от логики).

Чекбокс не отображается на форме

Причина: элемент скрыт свойством Видимость или размещен за пределами видимой области.

Решение:

• 🔹 Проверьте координаты и размеры чекбокса в свойствах.
• 🔹 Убедитесь, что у родительского контейнера (например, группы) установлена Видимость = Истина.
• 🔹 Для управляемых форм проверьте, что элемент не скрыт условием в свойстве Видимость.
💡

Всегда тестируйте работу чекбоксов в пользовательском режиме, а не только в Конфигураторе. Некоторые ошибки (например, связанные с правами доступа) проявляются только при реальной работе.

Еще одна типичная проблема — зацикливание при программном изменении значения чекбокса внутри обработчика ПриИзменении. Чтобы избежать этого, используйте флаг блокировки:

Перем БлокировкаОбработкиФлажка;

Процедура ФлажокОплатаПриИзменении(Элемент)
Если БлокировкаОбработкиФлажка Тогда
Возврат;
КонецЕсли;

БлокировкаОбработкиФлажка = Истина;
Если Элемент.Значение Тогда
Объект.СуммаОплаты = Объект.СуммаДокумента;
Иначе
Объект.СуммаОплаты = 0;
КонецЕсли;
БлокировкаОбработкиФлажка = Ложь;
КонецПроцедуры

Примеры использования чекбоксов в типовых конфигурациях

Чекбоксы широко применяются в типовых конфигурациях 1С, таких как 1С:Бухгалтерия 3.0, 1С:Управление Торговлей 11 и 1С:Зарплата и Управление Персоналом 3.1. Рассмотрим несколько практических примеров.

1. Чекбокс "Печатать сразу" в документах

В документах РеализацияТоваровУслуг или ПоступлениеТоваров часто встречается флажок "Печатать сразу", который автоматически открывает печатную форму после проведения:

Процедура ФлажокПечататьСразуПриИзменении(Элемент)
ЭлементыФормы.КнопкаПечать.Видимость = Элемент.Значение;
КонецПроцедуры

Процедура ПередЗаписью(Отказ, РежимЗаписи)
Если Объект.ПечататьСразу Тогда
ПечатьДокумента();
КонецЕсли;
КонецПроцедуры

2. Флажок "Показывать удаленные" в списках

В справочниках и документах чекбокс "Показывать удаленные" управляет отображением помеченных на удаление объектов:

Процедура ФлажокПоказыватьУдаленныеПриИзменении(Элемент)
ОбновитьСписок();
КонецПроцедуры

Процедура ОбновитьСписок()
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ РАЗРЕШЕННЫЕ Справочник.Номенклатура КАК Номенклатура
|ГДЕ НЕ Номенклатура.ПометкаУдаления = Истина ИЛИ ?(ПоказыватьУдаленные, Истина, Ложь)";
Запрос.УстановитьПараметр("ПоказыватьУдаленные", ЭлементыФормы.ФлажокПоказыватьУдаленные.Значение);
Результат = Запрос.Выполнить();
СписокНоменклатуры.Закрыть();
СписокНоменклатуры.Список = Результат.Выгрузить();
КонецПроцедуры

3. Чекбоксы в отчетах для фильтрации данных

В отчете ВедомостьПоТоварам можно добавить флажки для гибкой настройки выводимых данных:

Процедура ФлажокТолькоВНаличииПриИзменении(Элемент)
Если Элемент.Значение Тогда
Отчет.ПараметрыДанных.Фильтр.Добавить("Остаток", ЗначениеЗаполнено());
Иначе
Отчет.ПараметрыДанных.Фильтр.Удалить("Остаток");
КонецЕсли;
ОбновитьОтчет();
КонецПроцедуры

💡

В типовых конфигурациях часто используются чекбоксы с привязкой к функциональным опциям (например, "Использовать управленческий учет" в 1С:Бухгалтерия). Изменение таких флажков может требовать перезапуска программы или обновления конфигурации.

FAQ: Частые вопросы о чекбоксах в 1С

Как сделать чекбокс обязательным для заполнения?

В 1С нет прямого свойства "Обязательное" для чекбоксов, но можно эмулировать это поведение:

1. Добавьте проверку в процедуре ПередЗаписью():

Процедура ПередЗаписью(Отказ, РежимЗаписи)
Если Не Объект.СогласиеНаОбработкуДанных Тогда
Сообщить("Необходимо дать согласие на обработку данных!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

2. Для управляемых форм можно также выделить чекбокс красным, если он не установлен:

Процедура ФлажокСогласиеПриИзменении(Элемент)
Если Не Элемент.Значение Тогда
Элемент.ЦветТекста = ВебЦвет.Красный;
Иначе
Элемент.ЦветТекста = ВебЦвет.Авто;
КонецЕсли;
КонецПроцедуры

Можно ли связать чекбокс с полем типа "Число" или "Строка"?

Прямая связь чекбокса с небулевыми типами данных невозможна, но можно использовать обходные пути:

1. Для Число: свяжите чекбокс с булевым реквизитом, а в процедуре ПриИзменении обновляйте числовое поле:

   Процедура ФлажокСкидкаПриИзменении(Элемент)
   Объект.ПроцентСкидки = ?(Элемент.Значение, 10, 0);
   КонецПроцедуры

2. Для Строка: аналогично используйте булевый реквизит и преобразуйте его в строку при необходимости:

   Процедура ФлажокАктивенПриИзменении(Элемент)
   Объект.Статус = ?(Элемент.Значение, "Активен", "Неактивен");
   КонецПроцедуры

Как программно установить или снять флажок?

Чтобы изменить состояние чекбокса из кода, используйте свойство Значение:

// Для обычной формы:
ЭлементыФормы.ФлажокОплачено.Значение = Истина;

// Для управляемой формы:
ЭлементыФормы.ФлажокОплачено.Значение = Истина;

Если чекбокс связан с реквизитом объекта, изменение значения через элемент формы автоматически обновит и реквизит (и наоборот).

Важно: при программном изменении значения чекбокса событие ПриИзменении срабатывает, поэтому может возникнуть зацикливание. Чтобы избежать этого, используйте флаг блокировки (см. раздел про типичные ошибки).

Почему чекбокс не реагирует на клики?
Возможные причины и решения:
• 🔹 Элемент заблокирован: проверьте свойство Доступность (должно быть Истина).
• 🔹 Нет прав: пользователь может не иметь прав на изменение связанного реквизита.