Тип: Строка. Содержит текст шапки колонки.
Полное описание, параметры и ограничения
КолонкаТабличногоПоля.ТекстШапки (TableBoxColumn.HeaderText)
КолонкаТабличногоПоля (TableBoxColumn)
ТекстШапки (HeaderText)
Доступен, начиная с версии 8.0.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит текст шапки колонки.
Доступность:
Толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Назначить флажок для собственного булевого поля
Устанавливаем элемент управления Флажок для колонки Выбран. При нажатии кнопки меняется только отметка книги, количество товаров не меняется.
Где и как запускать
Модуль новой обычной формы внешней обработки. Только толстый клиент, обычные формы; не серверный модуль и не управляемая форма.
Подготовка
Это обычная форма, не управляемая: используйте толстый клиент с обычными формами в отдельной учебной базе. Создайте новую внешнюю обработку, обычную форму и её реквизит Товары типа ТаблицаЗначений. Рабочие документы и справочники не нужны.
В редакторе формы добавьте табличное поле ТаблицаТоваров, свойство Данные свяжите с реквизитом Товары. Добавьте обычную кнопку УчебнаяКоманда, её действие свяжите с процедурой УчебнаяКоманда. ПриОткрытии свяжите с одноимённым событием формы.
Каждый урок — отдельный полный модуль этой учебной формы. Он заново создаёт в памяти Книгу (3) и Ручку (1), а СоздатьКолонки удаляет прежние колонки только своего табличного поля. Не вставляйте код в рабочую форму с настроенными колонками.
Откройте форму, затем нажмите учебную кнопку. Изменения данных и оформления относятся только к реквизиту внешней обработки в памяти. Здесь нет Записать, обращения к рабочим данным или проверки интерфейса реальной УТ 10.3.
Процедура ПриОткрытии()
Товары = Новый ТаблицаЗначений;
Товары.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Товары.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Товары.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Товары.Колонки.Добавить("Выбран", Новый ОписаниеТипов("Булево"));
Книга = Товары.Добавить();
Книга.Код = "A-01";
Книга.Наименование = "Книга";
Книга.Количество = 3;
Книга.Выбран = Ложь;
Ручка = Товары.Добавить();
Ручка.Код = "B-02";
Ручка.Наименование = "Ручка";
Ручка.Количество = 1;
Ручка.Выбран = Ложь;
Таблица = ЭтаФорма.ЭлементыФормы.ТаблицаТоваров;
Таблица.СоздатьКолонки();
Таблица.АвтоВводНовойСтроки = Ложь;
Если Товары.Количество() <> 2 Тогда
ВызватьИсключение "Ожидались два собственных учебных товара";
КонецЕсли;
Таблица.ТекущаяСтрока = Товары[0];
КолонкаВыбора = Таблица.Колонки.Найти("Выбран");
Если КолонкаВыбора = Неопределено Тогда
ВызватьИсключение "Нет собственной булевой колонки Выбран";
КонецЕсли;
КолонкаВыбора.УстановитьЭлементУправления(Тип("Флажок"));
КолонкаВыбора.Данные = "Выбран";
КолонкаВыбора.ТекстШапки = "Отметка";
КолонкаВыбора.ТриСостоянияФлажка = Ложь;
КолонкаВыбора.РежимРедактирования = РежимРедактированияКолонки.Непосредственно;
КонецПроцедуры
Процедура УчебнаяКоманда(Кнопка)
Таблица = ЭтаФорма.ЭлементыФормы.ТаблицаТоваров;
Товары[0].Выбран = Не Товары[0].Выбран;
Таблица.ОбновитьСтроки();
КолонкаВыбора = Таблица.Колонки.Найти("Выбран");
Если КолонкаВыбора = Неопределено Тогда
ВызватьИсключение "Колонка отметки исчезла из учебной формы";
КонецЕсли;
Сообщить(ТипЗнч(КолонкаВыбора.ЭлементУправления) = Тип("Флажок"));
Сообщить(Не КолонкаВыбора.ТриСостоянияФлажка);
Сообщить("Книга отмечена: " + Строка(Товары[0].Выбран));
Сообщить(Товары.Количество() = 2 И Товары.Итог("Количество") = 4);
КонецПроцедурыРазбор по шагам
Булево поле Выбран создано в собственной таблице со значением Ложь.
УстановитьЭлементУправления принимает Тип(Флажок), не экземпляр нового флажка. ЭлементУправления только читается.
ТриСостоянияФлажка=Ложь соответствует двум булевым значениям. Неопределено как третье состояние здесь не используется.
Прямое редактирование отличается от входа в отдельный режим редактирования строки.
Кнопка инвертирует только булево значение книги и обновляет отображение. Сумма количества остаётся 4.
Как проверить результат
Три сравнения Истина; диагностическая отметка меняется при каждом нажатии.
Новая строка или запись базы не создаётся.
Ожидаемый результат
Проверена замена редактора колонки и связь флажка с собственными данными.
На что обратить внимание
ЭлементУправления только для чтения, прямое присваивание ему запрещено.
ДанныеФлажка — иной механизм дополнительного флажка колонки; его не требуется задавать для этой самостоятельной булевой колонки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Оформить числовую колонку количества
Колонка связана с полем Количество, имеет заголовок и формат без дробных знаков. Пользователь может менять ширину, но не положение этой колонки.
Где и как запускать
Модуль новой обычной формы внешней обработки. Только толстый клиент, обычные формы; не серверный модуль и не управляемая форма.
Подготовка
Это обычная форма, не управляемая: используйте толстый клиент с обычными формами в отдельной учебной базе. Создайте новую внешнюю обработку, обычную форму и её реквизит Товары типа ТаблицаЗначений. Рабочие документы и справочники не нужны.
В редакторе формы добавьте табличное поле ТаблицаТоваров, свойство Данные свяжите с реквизитом Товары. Добавьте обычную кнопку УчебнаяКоманда, её действие свяжите с процедурой УчебнаяКоманда. ПриОткрытии свяжите с одноимённым событием формы.
Каждый урок — отдельный полный модуль этой учебной формы. Он заново создаёт в памяти Книгу (3) и Ручку (1), а СоздатьКолонки удаляет прежние колонки только своего табличного поля. Не вставляйте код в рабочую форму с настроенными колонками.
Откройте форму, затем нажмите учебную кнопку. Изменения данных и оформления относятся только к реквизиту внешней обработки в памяти. Здесь нет Записать, обращения к рабочим данным или проверки интерфейса реальной УТ 10.3.
Процедура ПриОткрытии()
Товары = Новый ТаблицаЗначений;
Товары.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Товары.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Товары.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Товары.Колонки.Добавить("Выбран", Новый ОписаниеТипов("Булево"));
Книга = Товары.Добавить();
Книга.Код = "A-01";
Книга.Наименование = "Книга";
Книга.Количество = 3;
Книга.Выбран = Ложь;
Ручка = Товары.Добавить();
Ручка.Код = "B-02";
Ручка.Наименование = "Ручка";
Ручка.Количество = 1;
Ручка.Выбран = Ложь;
Таблица = ЭтаФорма.ЭлементыФормы.ТаблицаТоваров;
Таблица.СоздатьКолонки();
Таблица.АвтоВводНовойСтроки = Ложь;
Если Товары.Количество() <> 2 Тогда
ВызватьИсключение "Ожидались два собственных учебных товара";
КонецЕсли;
Таблица.ТекущаяСтрока = Товары[0];
Колонка = Таблица.Колонки.Найти("Количество");
Если Колонка = Неопределено Тогда
ВызватьИсключение "В своей таблице не найдена колонка количества";
КонецЕсли;
Колонка.Данные = "Количество";
Колонка.ТекстШапки = "Количество книг";
Колонка.ПодсказкаВШапке = "Собственные 3 книги и 1 ручка";
Колонка.ОтображатьВШапке = Истина;
Колонка.Ширина = 16;
Колонка.АвтоВысотаЯчейки = Ложь;
Колонка.ВысотаЯчейки = 1;
Колонка.Формат = "ЧДЦ=0";
Колонка.ГоризонтальноеПоложениеВКолонке = ГоризонтальноеПоложение.Право;
Колонка.ГоризонтальноеПоложениеВШапке = ГоризонтальноеПоложение.Центр;
Колонка.ГоризонтальноеПоложениеВПодвале = ГоризонтальноеПоложение.Право;
Колонка.Положение = ПоложениеКолонки.НоваяКолонка;
Колонка.ИзменениеРазмера = ИзменениеРазмераКолонки.Изменять;
Колонка.ИзменятьПозицию = Ложь;
Колонка.ИзменятьНастройку = Истина;
Таблица.ИзменятьНастройкуКолонок = Истина;
Таблица.ИзменятьПозициюКолонок = Ложь;
КонецПроцедуры
Процедура УчебнаяКоманда(Кнопка)
Таблица = ЭтаФорма.ЭлементыФормы.ТаблицаТоваров;
Колонка = Таблица.Колонки.Найти("Количество");
Если Колонка = Неопределено Тогда
ВызватьИсключение "В своей таблице не найдена колонка количества";
КонецЕсли;
Сообщить(Колонка.Данные = "Количество");
Сообщить(Колонка.Формат = "ЧДЦ=0");
Сообщить(Колонка.ТекстШапки = "Количество книг");
Сообщить("Выделение отрицательных: " + Строка(Колонка.ВыделятьОтрицательные));
Сообщить("Пропускать при вводе: " + Строка(Колонка.ПропускатьПриВводе));
Сообщить(Товары[0].Количество = 3);
КонецПроцедурыРазбор по шагам
Данные — имя существующего поля таблицы значений, ТекстШапки — видимая подпись. Их не смешиваем.
Формат ЧДЦ=0 меняет отображение, само число 3 остаётся числом.
Горизонтальные положения отдельно задаются для ячеек, шапки и подвала.
Ширина 16 не является обещанием 16 пикселей. АвтоВысотаЯчейки выключена, высота явно одна строка.
Разрешение размера и настройки не означает разрешение перестановки: на уровне колонки и таблицы перестановка отключена. ВыделятьОтрицательные и ПропускатьПриВводе читаем, не присваиваем.
Как проверить результат
Четыре сравнения Истина и две диагностические строки.
Проверьте ширину вручную: значения зависят от шрифта и масштаба интерфейса.
Ожидаемый результат
Связь с данными, формат и три выравнивания проверены отдельно.
На что обратить внимание
ВыделятьОтрицательные и ПропускатьПриВводе только для чтения.
Пользовательское изменение ширины не меняет числовое количество.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.