ТаблицаФормы.ВысотаВСтрокахТаблицы

Свойства · HeightInTableRows

Тип: Число. Содержит высоту таблицы. Задается в строках. Указывает количество строк, отображаемых в области данных таблицы. Таблица занимает такую высоту, чтобы разместились шапка, подвал и заданное число строк в области данных. Число строк в общем случае не является числом записей данных, отображаемых в таблице, так как одна запись данных может выводиться в несколько строк таблицы. Более того, разные строки данных могут занимать разную высоту. Используется при расчете макета формы.

Полное описание, параметры и ограничения

ТаблицаФормы.ВысотаВСтрокахТаблицы (FormTable.HeightInTableRows)

ТаблицаФормы (FormTable)

ВысотаВСтрокахТаблицы (HeightInTableRows)

Доступен, начиная с версии 8.2.

Использование:
Чтение и запись.
Описание:
Тип: Число.
Содержит высоту таблицы. Задается в строках. Указывает количество строк, отображаемых в области данных таблицы. Таблица занимает такую высоту, чтобы разместились шапка, подвал и заданное число строк в области данных. Число строк в общем случае не является числом записей данных, отображаемых в таблице, так как одна запись данных может выводиться в несколько строк таблицы. Более того, разные строки данных могут занимать разную высоту.
Используется при расчете макета формы.
Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Изменение свойства на клиенте требует обращения к серверу.

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация

Практические примеры

Задать высоту в строках таблицы и ограничить ширину

Размеры задают раскладку элемента, не количество данных. Кнопка меняет размеры на сервере, не добавляя учебные товары.

Где и как запускать

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

Подготовка

  1. В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.

  2. Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.

  3. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.

  4. Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.

  5. Проверяйте в настольном тонком/толстом или веб-клиенте 8.5.1.1343, не в мобильном приложении. Для каждого урока отдельная учебная форма с пустым модулем.

  6. Изменение учебных строк остаётся только в открытой форме. При её новом открытии снова создаются Книга/3 и Ручка/1. Настройки таблицы не являются правами доступа к данным.


&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    НовыеРеквизиты = Новый Массив;
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
    ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
    Данные = Новый ТаблицаЗначений;
    Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));

    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "A-01";
    СтрокаТовара.Наименование = "Книга";
    СтрокаТовара.Количество = 3;
    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "B-02";
    СтрокаТовара.Наименование = "Ручка";
    СтрокаТовара.Количество = 1;

    ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
    Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
    Таблица.ПутьКДанным = "Товары";
    Таблица.Заголовок = "Учебные товары";
    Таблица.Шапка = Истина;
    Таблица.АвтоВводНезаполненного = Ложь;
    Таблица.АвтоВводНовойСтроки = Ложь;
    Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
        Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
        Колонка.Вид = ВидПоляФормы.ПолеВвода;
        Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
        Колонка.Заголовок = ИмяКолонки;
    КонецЦикла;
    Таблица.ВариантУправленияВысотой = ВариантУправленияВысотойТаблицы.ВСтрокахТаблицы;
    Таблица.ВысотаВСтрокахТаблицы = 5;
    Таблица.АвтоМаксимальнаяВысотаВСтрокахТаблицы = Ложь;
    Таблица.МаксимальнаяВысотаВСтрокахТаблицы = 8;
    Таблица.Ширина = 50;
    Таблица.АвтоМаксимальнаяШирина = Ложь;
    Таблица.МаксимальнаяШирина = 70;

    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Переключить размеры";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    ПереключитьРазмерыНаСервере();
КонецПроцедуры

&НаСервере
Процедура ПереключитьРазмерыНаСервере()
    Таблица = Элементы.ТаблицаТоваров;
    Если Таблица.ВысотаВСтрокахТаблицы = 5 Тогда
        Таблица.МаксимальнаяВысотаВСтрокахТаблицы = 10;
        Таблица.ВысотаВСтрокахТаблицы = 8;
        Таблица.МаксимальнаяШирина = 100;
        Таблица.Ширина = 80;
    Иначе
        Таблица.ВысотаВСтрокахТаблицы = 5;
        Таблица.МаксимальнаяВысотаВСтрокахТаблицы = 8;
        Таблица.Ширина = 50;
        Таблица.МаксимальнаяШирина = 70;
    КонецЕсли;
    Сообщить(СтрШаблон("Высота %1; ширина %2; данных %3",
        Таблица.ВысотаВСтрокахТаблицы, Таблица.Ширина, Товары.Количество()));
КонецПроцедуры

Разбор по шагам

  1. Явно выбираем ВСтрокахТаблицы: иначе свойства другого варианта высоты могут игнорироваться.

  2. ВысотаВСтрокахТаблицы — строки области отображения, не Товары.Количество(). Запись может занимать несколько визуальных строк.

  3. Чтобы использовать заданные максимумы, выключаем автоматические ограничения соответствующего измерения.

  4. Ширина измеряется в символах, не пикселях. Кнопка вызывает обычную серверную процедуру с контекстом формы.

  5. При увеличении сначала поднимаем максимум, затем желаемый размер; данные не меняются.

Как проверить результат

  1. Первое нажатие выводит высоту 8, ширину 80, данных 2. Второе — 5, 50, 2.

  2. Сверьте видимое изменение раскладки; точный размер в пикселях зависит от клиента, шрифтов и остальных элементов формы.

Ожидаемый результат

Показаны единицы размеров, выбор режима и зависимость явного максимума от автоматического ограничения.

На что обратить внимание

  1. Высота 8 не создаёт восемь товаров и не гарантирует восемь записей при переносах текста.

  2. Максимум 0 означает отсутствие заданного ограничения, а не нулевую высоту или ширину.

  3. Ограничения родительской группы и окна также влияют на фактическую раскладку.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Показать прокрутку на четырнадцати собственных строках

Создаём дополнительные учебные строки только в форме. Полосы прокрутки управляют просмотром, а не количеством выбранных товаров или страницами базы.

Где и как запускать

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

Подготовка

  1. В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.

  2. Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.

  3. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.

  4. Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.

  5. Проверяйте в настольном тонком/толстом или веб-клиенте 8.5.1.1343, не в мобильном приложении. Для каждого урока отдельная учебная форма с пустым модулем.

  6. Изменение учебных строк остаётся только в открытой форме. При её новом открытии снова создаются Книга/3 и Ручка/1. Настройки таблицы не являются правами доступа к данным.


&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    НовыеРеквизиты = Новый Массив;
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
    НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
    ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
    Данные = Новый ТаблицаЗначений;
    Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
        Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));

    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "A-01";
    СтрокаТовара.Наименование = "Книга";
    СтрокаТовара.Количество = 3;
    СтрокаТовара = Данные.Добавить();
    СтрокаТовара.Код = "B-02";
    СтрокаТовара.Наименование = "Ручка";
    СтрокаТовара.Количество = 1;

    ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
    Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
    Таблица.ПутьКДанным = "Товары";
    Таблица.Заголовок = "Учебные товары";
    Таблица.Шапка = Истина;
    Таблица.АвтоВводНезаполненного = Ложь;
    Таблица.АвтоВводНовойСтроки = Ложь;
    Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
        Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
        Колонка.Вид = ВидПоляФормы.ПолеВвода;
        Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
        Колонка.Заголовок = ИмяКолонки;
    КонецЦикла;
    Таблица.ВариантУправленияВысотой = ВариантУправленияВысотойТаблицы.ВСтрокахТаблицы;
    Таблица.ВысотаВСтрокахТаблицы = 5;
    Таблица.РастягиватьПоВертикали = Ложь;
    Таблица.Ширина = 45;
    Таблица.РастягиватьПоГоризонтали = Ложь;
    Таблица.ВертикальнаяПолосаПрокрутки = ИспользованиеПолосыПрокрутки.ИспользоватьВсегда;
    Таблица.ГоризонтальнаяПолосаПрокрутки = ИспользованиеПолосыПрокрутки.ИспользоватьВсегда;
    Элементы.ТоварыНаименование.Ширина = 80;
    Для Номер = 1 По 12 Цикл
        Новая = ЭтаФорма.Товары.Добавить();
        Новая.Код = "TRAIN-" + Строка(Номер);
        Новая.Наименование = "Собственная учебная строка " + Строка(Номер);
        Новая.Количество = 1;
    КонецЦикла;
    Сообщить(ЭтаФорма.Товары.Количество() = 14);
    Сообщить(ЭтаФорма.Товары.Итог("Количество") = 16);
КонецПроцедуры

Разбор по шагам

  1. После загрузки Книги/3 и Ручки/1 добавляем ещё двенадцать собственных строк с количеством 1.

  2. Явно выбираем высоту в строках таблицы и небольшую область просмотра.

  3. Полосы прокрутки включаем всегда; широкая колонка помогает изучить горизонтальный просмотр при ограниченном окне.

  4. Количество() и Итог относятся ко всем данным, не только к пяти видимым строкам.

Как проверить результат

  1. Обе логические проверки Истина: 14 строк и суммарное количество 16.

  2. Прокрутите до TRAIN-12; измените размер окна и сравните видимость полос. Данные остаются теми же.

Ожидаемый результат

На конкретных данных разделены область просмотра, строки коллекции и полоса прокрутки.

На что обратить внимание

  1. Фактическая раскладка зависит также от минимальных размеров окна/групп.

  2. Это не серверная постраничная загрузка и не выборка рабочего справочника.

  3. НеИспользовать у полосы может ухудшить доступность скрытой области; не выключайте её без проверки.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.