Тип: Строка. Содержит текст флажка.
Полное описание, параметры и ограничения
Флажок.Заголовок (CheckBox.Caption)
Флажок (CheckBox)
Заголовок (Caption)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит текст флажка.
Доступность:
Толстый клиент.
Примечание:
Если текст не умещается по ширине, он автоматически разбивается на несколько строк с переносом по словам. Если перенос по словам не возможен, видимый текст будет заканчиваться троеточием. Если разбитый на строки текст не умещается по высоте, то он будет прижат к верхней границе независимо от установленного способа выравнивания по вертикали, не уместившиеся строки не будут показаны.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Управлять булевым флажком и проверить его оформление
Один собственный флажок задаёт учебное «Включать доставку». Кнопка инвертирует Булево и показывает новое состояние.
Где и как запускать
Полный модуль собственной обычной формы внешней обработки. Только толстый клиент с обычными формами; действие кнопки — экспортная процедура с первым параметром Элемент, инициировавшим Нажатие.
Подготовка
Создайте отдельную внешнюю обработку с обычной формой. Нужен толстый клиент в режиме обычных форм; рабочая база не используется.
Добавьте обычную кнопку УчебнаяКоманда. ПриОткрытии формы свяжите с одноимённой процедурой из полного модуля; Нажатие кнопки вручную не назначайте.
Кнопка получает собственное Действие в коде. Каждый урок заменяет полный модуль отдельной копии формы; никаких записей документов или настроек нет.
Добавьте реквизит УчебнаяДоставка (Булево) и Флажок с именем УчебныйФлажок. В свойстве Данные укажите УчебнаяДоставка.
Процедура ПриОткрытии()
УчебнаяДоставка = Ложь;
Флажок = ЭтаФорма.ЭлементыФормы.УчебныйФлажок;
Флажок.ТриСостояния = Ложь;
Флажок.Доступность = Истина;
Флажок.Заголовок = "Включать учебную доставку";
Флажок.Подсказка = "Меняется только собственное Булево формы";
Флажок.ПоложениеЗаголовка = ПоложениеЗаголовка.ЗаголовокСправа;
Флажок.ГоризонтальноеПоложение = ГоризонтальноеПоложение.Лево;
Флажок.ВертикальноеПоложение = ВертикальноеПоложение.Центр;
Флажок.ПрозрачныйФон = Ложь;
Флажок.ЦветФона = Новый Цвет(244, 248, 252);
Флажок.ЦветТекста = Новый Цвет(24, 40, 60);
Флажок.ЦветФонаПоля = Новый Цвет(255, 255, 255);
Флажок.ЦветТекстаПоля = Новый Цвет(30, 110, 80);
Флажок.ЦветРамки = Новый Цвет(160, 176, 192);
Флажок.Рамка = Новый Рамка(ТипРамки.Одинарная);
Флажок.Шрифт = Новый Шрифт(Флажок.Шрифт, , 11, Ложь);
Кнопка = ЭтаФорма.ЭлементыФормы.УчебнаяКоманда;
Кнопка.Заголовок = "Выполнить учебный шаг";
Кнопка.УстановитьДействие("Нажатие", Новый Действие("ВыполнитьУчебныйШаг"));
КонецПроцедуры
Процедура ВыполнитьУчебныйШаг(Элемент) Экспорт
УчебнаяДоставка = Не УчебнаяДоставка;
Сообщить(УчебнаяДоставка);
Сообщить(ТипЗнч(УчебнаяДоставка) = Тип("Булево"));
Флажок = ЭтаФорма.ЭлементыФормы.УчебныйФлажок;
Сообщить(Флажок.Доступность И Не Флажок.ТриСостояния);
Сообщить(Флажок.Шрифт.Размер = 11);
КонецПроцедурыРазбор по шагам
Связанный реквизит имеет тип Булево; ТриСостояния выключено, поэтому пример не смешивает число и логический признак.
Не инвертирует именно значение реквизита. Изображение галочки обновляется через связь Данные.
ЦветТекста оформляет подпись, ЦветТекстаПоля — галочку. ЦветФона и ЦветФонаПоля относятся к разным областям.
ПоложениеЗаголовка выбирает сторону подписи; вертикальное и горизонтальное положение уточняют расположение текста.
Шрифт сохраняет прежнее имя и меняет размер; никаких заказов или настроек доставки код не записывает.
Как проверить результат
Первое нажатие: четыре Истина. Второе: Ложь, затем три Истина.
Измените флажок мышью и нажмите кнопку: значение должно инвертироваться относительно вашего выбора.
Ожидаемый результат
Реальный флажок изменяет собственный логический реквизит формы.
На что обратить внимание
Доступность элемента не заменяет проверку прав на сервере.
Видимые цвета зависят от темы и клиента; пиксельное отображение не проверялось.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Изучить числовые состояния трёхсостоянийного флажка
Отдельная числовая форма проходит значения 0→1→2→0. Связанный реквизит — Число, а не Булево.
Где и как запускать
Полный модуль собственной обычной формы внешней обработки. Только толстый клиент с обычными формами; действие кнопки — экспортная процедура с первым параметром Элемент, инициировавшим Нажатие.
Подготовка
Создайте отдельную внешнюю обработку с обычной формой. Нужен толстый клиент в режиме обычных форм; рабочая база не используется.
Добавьте обычную кнопку УчебнаяКоманда. ПриОткрытии формы свяжите с одноимённой процедурой из полного модуля; Нажатие кнопки вручную не назначайте.
Кнопка получает собственное Действие в коде. Каждый урок заменяет полный модуль отдельной копии формы; никаких записей документов или настроек нет.
В другой копии добавьте УчебноеСостояние (Число 1.0) и Флажок УчебныйФлажок с Данные = УчебноеСостояние. Не используйте булевый реквизит первого урока.
Процедура ПриОткрытии()
УчебноеСостояние = 0;
Флажок = ЭтаФорма.ЭлементыФормы.УчебныйФлажок;
Флажок.ТриСостояния = Истина;
Флажок.Заголовок = "Учебные числовые состояния";
Кнопка = ЭтаФорма.ЭлементыФормы.УчебнаяКоманда;
Кнопка.Заголовок = "Выполнить учебный шаг";
Кнопка.УстановитьДействие("Нажатие", Новый Действие("ВыполнитьУчебныйШаг"));
КонецПроцедуры
Процедура ВыполнитьУчебныйШаг(Элемент) Экспорт
Если ТипЗнч(УчебноеСостояние) <> Тип("Число") Тогда
ВызватьИсключение "Для трёх состояний нужен числовой реквизит";
КонецЕсли;
Если УчебноеСостояние = 0 Тогда
УчебноеСостояние = 1;
ИначеЕсли УчебноеСостояние = 1 Тогда
УчебноеСостояние = 2;
Иначе
УчебноеСостояние = 0;
КонецЕсли;
Сообщить(УчебноеСостояние);
Сообщить(ТипЗнч(УчебноеСостояние) = Тип("Число"));
КонецПроцедурыРазбор по шагам
ТриСостояния = Истина требует числового редактируемого значения; это прямо указано в локальной справке.
Перед изменением проверяем тип. Не применяем логическое Не к числу.
Кнопка задаёт контролируемый цикл 0, 1, 2; показанное число относится к реальному связанному реквизиту.
После каждого шага сравните вид флажка и число. Смысл числового состояния в прикладных данных необходимо описывать отдельно, а не считать его разрешением доставки.
Как проверить результат
Три последовательных нажатия выводят 1, 2, 0; после каждого Истина проверки типа.
Закройте и откройте форму: исходное значение снова 0. Проверьте изменение мышью отдельно.
Ожидаемый результат
Числовой цикл трёхсостоянийного поля не выдается за булевый бизнес-признак.
На что обратить внимание
Не подключайте ТриСостояния к Булево.
Не переносите числа состояния в рабочие перечисления без явного преобразования и бизнес-правила.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.