Тип: ПоложениеЗаголовкаЭлементаФормы. Определяет положение заголовка относительно поля в макете формы. Следует заметить, что для отключения вывода заголовка следует установить это свойство в значение Нет. Свойство Заголовок, содержащее пустую строку, означает автоматическое определение заголовка, а не ее отключение. Для полей (колонок), размещенных в таблице, любое значение данного свойства, кроме Нет, означает отображение заголовка в заголовке колонки.
Полное описание, параметры и ограничения
ПолеФормы.ПоложениеЗаголовка (FormField.TitleLocation)
ПолеФормы (FormField)
ПоложениеЗаголовка (TitleLocation)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: ПоложениеЗаголовкаЭлементаФормы.
Определяет положение заголовка относительно поля в макете формы. Следует заметить, что для отключения вывода заголовка следует установить это свойство в значение Нет. Свойство Заголовок, содержащее пустую строку, означает автоматическое определение заголовка, а не ее отключение.
Для полей (колонок), размещенных в таблице, любое значение данного свойства, кроме Нет, означает отображение заголовка в заголовке колонки.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Изменение свойства на клиенте может потребовать обращения к серверу.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Сделать читаемое многострочное поле описания с подсказкой
Пустое поле показывает подсказку без заголовка. Введённое описание переносится по ширине; размеры, цвет и шрифт заданы на создании формы.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(500));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = "";
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Учебное описание";
Поле.ПоложениеЗаголовка = ПоложениеЗаголовкаЭлементаФормы.Нет;
Поле.ПодсказкаВвода = "Описание учебного товара — не более 500 символов";
Поле.МногострочныйРежим = Истина;
Поле.АвтоПереносСтрок = Истина;
Поле.Высота = 5;
Поле.Ширина = 60;
Поле.АвтоМаксимальнаяВысота = Ложь;
Поле.МаксимальнаяВысота = 8;
Поле.АвтоМаксимальнаяШирина = Ложь;
Поле.МаксимальнаяШирина = 90;
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Ложь;
Поле.ЦветФона = Новый Цвет(245, 248, 252);
Поле.ЦветТекста = Новый Цвет(25, 45, 70);
Поле.ЦветРамки = Новый Цвет(160, 180, 200);
Поле.Шрифт = Новый Шрифт("Arial", 11);
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить длину описания";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ПустаяСтрока(ЗначениеПримера) Тогда
Сообщить("Введите описание учебного товара.");
Возврат;
КонецЕсли;
Сообщить("Длина текста: " + Строка(СтрДлина(ЗначениеПримера)));
Сообщить("Текст сохраняется только до закрытия учебной формы");
КонецПроцедуры
Разбор по шагам
Реквизит ограничен 500 символами; это ограничение данных, отдельно от ширины визуального поля.
ПодсказкаВвода видна у пустого строкового поля без фокуса, когда заголовок скрыт.
МногострочныйРежим разрешает несколько строк; АвтоПереносСтрок переносит длинную строку по ширине поля.
Высота/Ширина измеряются единицами формы, не пикселями. При отключении автоматического максимума применяются заданные пределы.
Цвета и шрифт улучшают оформление. Команда проверяет пустой текст и сообщает длину без записи в базу.
Как проверить результат
При открытии пустое поле без фокуса показывает подсказку внутри себя.
Введите несколько строк и длинное предложение: переносится текст, а не изменяется длина реквизита.
После очистки команда просит описание; для непустого текста сообщает длину.
Ожидаемый результат
Создано читаемое поле описания с ограничением данных, переносом строк и проверяемым поведением подсказки.
На что обратить внимание
Автоматический перенос по ширине не добавляет обязательные переводы строк в хранимый текст.
ПодсказкаВвода не заменяет постоянную подпись обязательного поля в рабочей форме.
Шрифты, тема и масштаб клиента могут менять внешний вид. Для учебного примера код не меняет тему конфигурации.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Перестроить собственные поля страницы горизонтально и вертикально
Настройки применяются к странице с четырьмя реальными полями. Команда меняет группировку, сохраняя учебные данные.
Где и как запускать
Полный модуль своей новой управляемой формы внешней обработки. Данные только в памяти формы.
Подготовка
В своей отдельной конфигурации УчебнаяКонфигурацияСинтаксиса создайте новую внешнюю обработку с пустой управляемой основной формой. Каждый урок вставляйте в отдельную копию формы целым модулем.
В событии формы ПриСозданииНаСервере назначьте одноимённый обработчик. Не создавайте вручную реквизиты НазваниеТовара, Количество, Цена, Сумма, две страницы и команду: код создаёт их сам.
Первая страница содержит вымышленную Книгу: количество 3, цена 250, сумма 750. Это только значения формы, не номенклатура, цены, документ или регистр базы.
Другая страница с собственным пояснением нужна для ручного переключения вкладок. Команда находится вне страниц и не скрывается при переключении.
Используйте настольный тонкий/толстый клиент 8.5.1.1343. Сохранённые свойства не доказывают видимый эффект во всех темах и интерфейсах; размеры окна и внешний вид проверяются вручную.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Реквизиты = Новый Массив;
Реквизиты.Добавить(Новый РеквизитФормы("НазваниеТовара", Новый ОписаниеТипов("Строка")));
Для Каждого Имя Из СтрРазделить("Количество,Цена,Сумма", ",") Цикл
Реквизиты.Добавить(Новый РеквизитФормы(Имя, Новый ОписаниеТипов("Число")));
КонецЦикла;
ЭтаФорма.ИзменитьРеквизиты(Реквизиты);
НазваниеТовара = "Книга";
Количество = 3;
Цена = 250;
Сумма = Количество * Цена;
Страницы = Элементы.Добавить("УчебныеСтраницы", Тип("ГруппаФормы"));
Страницы.Вид = ВидГруппыФормы.Страницы;
Страница = Элементы.Добавить("УчебнаяСтраницаКниги", Тип("ГруппаФормы"), Страницы);
Страница.Вид = ВидГруппыФормы.Страница;
Страница.Заголовок = "Собственная Книга";
Другая = Элементы.Добавить("УчебнаяСтраницаПояснения", Тип("ГруппаФормы"), Страницы);
Другая.Вид = ВидГруппыФормы.Страница;
Другая.Заголовок = "Что меняется";
Пояснение = Элементы.Добавить("УчебноеПояснение", Тип("ДекорацияФормы"), Другая);
Пояснение.Вид = ВидДекорацииФормы.Надпись;
Пояснение.Заголовок = "Меняются только элементы и значения собственной формы. Записи в базе нет.";
Для Каждого Имя Из СтрРазделить("НазваниеТовара,Количество,Цена,Сумма", ",") Цикл
Поле = Элементы.Добавить("УчебноеПоле" + Имя, Тип("ПолеФормы"), Страница);
Если Имя = "Сумма" Тогда
Поле.Вид = ВидПоляФормы.ПолеНадписи;
Иначе
Поле.Вид = ВидПоляФормы.ПолеВвода;
КонецЕсли;
Поле.ПутьКДанным = Имя;
Поле.Заголовок = Имя;
Поле.ПоложениеЗаголовка = ПоложениеЗаголовкаЭлементаФормы.Авто;
КонецЦикла;
Страницы.ТекущаяСтраница = Страница;
Страница.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Горизонтальная;
Страница.ГоризонтальныйИнтервал = ИнтервалМеждуЭлементамиФормы.Двойной;
Страница.ВертикальныйИнтервал = ИнтервалМеждуЭлементамиФормы.Одинарный;
Страница.ШиринаПодчиненныхЭлементов = ШиринаПодчиненныхЭлементовФормы.Одинаковая;
Страница.ПоложениеЗаголовковПодчиненных = ПоложениеЗаголовковПодчиненныхЭлементовФормы.Сверху;
Страница.ВыравниваниеЭлементовИЗаголовков = ВариантВыравниванияЭлементовИЗаголовков.ЭлементыЛевоЗаголовкиЛево;
Страница.ГоризонтальноеПоложениеПодчиненных = ГоризонтальноеПоложениеЭлемента.Лево;
Страница.ВертикальноеПоложениеПодчиненных = ВертикальноеПоложениеЭлемента.Верх;
Страница.ВертикальноеПоложение = ВертикальноеПоложениеЭлемента.Верх;
Страница.ВажностьПриОтображении = ВажностьПриОтображении.Обычная;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить собственную страницу";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Страница = Элементы.УчебнаяСтраницаКниги;
Если Страница.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Горизонтальная Тогда
Страница.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Вертикальная;
Иначе
Страница.Группировка = ГруппировкаПодчиненныхЭлементовФормы.Горизонтальная;
КонецЕсли;
Сообщить("Группировка: " + Строка(Страница.Группировка));
Сообщить(Страница.ГоризонтальныйИнтервал = ИнтервалМеждуЭлементамиФормы.Двойной);
Сообщить(Страница.ВертикальныйИнтервал = ИнтервалМеждуЭлементамиФормы.Одинарный);
Сообщить(Страница.ШиринаПодчиненныхЭлементов = ШиринаПодчиненныхЭлементовФормы.Одинаковая);
Сообщить(Страница.ПоложениеЗаголовковПодчиненных = ПоложениеЗаголовковПодчиненныхЭлементовФормы.Сверху);
Сообщить("Собственные данные остались: " + НазваниеТовара + ", " + Строка(Количество));
КонецПроцедурыРазбор по шагам
Группировка страницы организует реальные четыре дочерних поля, а не скрытый пустой контейнер.
ПоложениеЗаголовка каждого поля Авто, поэтому ПоложениеЗаголовковПодчиненных страницы может управлять его заголовком.
Задать относительные ширины и интервалы, отдельно выравнивание самой группы и подчинённых элементов.
Команда меняет только направление раскладки; данные формы не переназначает.
ВажностьПриОтображении относится к мобильной адаптации. Чтение этого свойства в настольном клиенте не доказывает мобильный эффект.
Как проверить результат
Первое нажатие выводит Вертикальная, второе Горизонтальная; четыре проверки интервалов/ширин/заголовков Истина.
Название Книга и количество 3 сохраняются. Если вы изменили поле вручную, сохраняется именно ваш текущий ввод.
Ожидаемый результат
Размещение страницы проверяется на её собственном наполнении с сохранением введённых значений.
На что обратить внимание
Одинаковая задаёт относительную ширину элементов, не гарантирует одинаковое число пикселей всех полей в любой раскладке.
ПоложениеЗаголовковПодчиненных не переопределяет заголовки флажков автоматически и игнорируется мобильным интерфейсом.
Горизонтальное размещение многих широких полей требует проверки небольшого окна, не только чтения enum.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.