Тип: Число. Содержит высоту кнопки. 0 - высота определяется автоматически.
Полное описание, параметры и ограничения
КнопкаФормы.Высота (FormButton.Height)
КнопкаФормы (FormButton)
Высота (Height)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Число.
Содержит высоту кнопки.
0 - высота определяется автоматически.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Подготовить учебную кнопку-карточку с читаемым заголовком
Карточка использует собственную фоновую картинку. Эффект фона помогает тексту, но не меняет выполняемую команду.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.
Проверяйте в установленной платформе 8.5.1.1343. Карточки и современное оформление дополнительно зависят от интерфейса, темы и режима совместимости; свойства не являются доказательством одинакового вида во всех клиентах.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебное количество";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
SVG = "<svg xmlns=""http://www.w3.org/2000/svg"" width=""32"" height=""32"" viewBox=""0 0 32 32""><rect width=""32"" height=""32"" rx=""6"" fill=""#146e32""/><path d=""M8 16l5 5 11-12"" fill=""none"" stroke=""white"" stroke-width=""3""/></svg>";
Байты = ПолучитьДвоичныеДанныеИзСтроки(SVG, КодировкаТекста.UTF8, Ложь);
УчебнаяКартинка = Новый Картинка(Байты);
Кнопка.ОтображатьКакКарточку = Истина;
Кнопка.ФоноваяКартинка = УчебнаяКартинка;
Кнопка.ЭффектОтображенияФоновойКартинки = ЭффектОтображенияКартинки.Полупрозрачность;
Кнопка.ВыравниваниеКартинкиИЗаголовкаКарточки = ВариантВыравниванияКартинкиИЗаголовкаКарточки.ГоризонтальноЦентрВертикальноЦентр;
Кнопка.Заголовок = "Проверить учебные товары";
Кнопка.Ширина = 32;
Кнопка.Высота = 4;
Сообщить(Кнопка.ОтображатьКакКарточку);
Сообщить(ТипЗнч(Кнопка.ФоноваяКартинка) = Тип("Картинка"));
Сообщить(Кнопка.ЭффектОтображенияФоновойКартинки = ЭффектОтображенияКартинки.Полупрозрачность);
Сообщить(Кнопка.ИмяКоманды = "УчебноеДействие");
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры
Разбор по шагам
Создаём фон из собственных SVG-байтов, не используем файл или URL.
ОтображатьКакКарточку и ВыравниваниеКартинкиИЗаголовкаКарточки описывают особый вид кнопки.
Полупрозрачность уменьшает влияние фона на читаемость; сама командная логика прежняя.
Проверяйте фактическую карточку в подходящем интерфейсе платформы 8.5; установка свойств не является снимком готового UI.
Как проверить результат
Четыре сравнения Истина: карточка, фоновая картинка, эффект и команда.
Проверьте текст, контраст и щелчок в своей теме: результат команды 2 строки и количество 4.
Ожидаемый результат
Создана конфигурация собственной кнопки-карточки с работающим учебным действием.
На что обратить внимание
При другом интерфейсе или режиме совместимости оформление может отличаться.
Нельзя считать полупрозрачность фона защитой данных или ограничением выполнения команды.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Задать ширину кнопки, автоматические пределы и растяжение
Размеры кнопки в API формы не задаются пикселями CSS. Сравниваем выбранную ширину с её максимальным ограничением.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.
Проверяйте в установленной платформе 8.5.1.1343. Карточки и современное оформление дополнительно зависят от интерфейса, темы и режима совместимости; свойства не являются доказательством одинакового вида во всех клиентах.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить учебное количество";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
Кнопка.Ширина = 28;
Кнопка.Высота = 0;
Кнопка.АвтоМаксимальнаяШирина = Ложь;
Кнопка.МаксимальнаяШирина = 36;
Кнопка.АвтоМаксимальнаяВысота = Ложь;
Кнопка.МаксимальнаяВысота = 0;
Кнопка.РастягиватьПоГоризонтали = Истина;
Кнопка.РастягиватьПоВертикали = Ложь;
Кнопка.ГоризонтальноеПоложениеВГруппе = ГоризонтальноеПоложениеЭлемента.Лево;
Кнопка.ВертикальноеПоложениеВГруппе = ВертикальноеПоложениеЭлемента.Центр;
Сообщить(Кнопка.Ширина = 28);
Сообщить(Кнопка.МаксимальнаяШирина = 36);
Сообщить(Кнопка.Высота = 0);
Сообщить(Не Кнопка.АвтоМаксимальнаяШирина);
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры
Разбор по шагам
Ширина задаётся в символах, а 0 у высоты означает автоматический размер.
МаксимальнаяШирина используется при выключенной АвтоМаксимальнаяШирина.
Растяжение и положение в группе — разные настройки; ширина ограничена максимумом.
После открытия меняйте размер окна и проверяйте фактическое отображение вручную.
Как проверить результат
Четыре сравнения Истина: ширина 28, предел 36, автоматическая высота и отключённый автоматический предел ширины.
Кнопка выполняет прежнюю команду; число символов не обещает конкретное число пикселей.
Ожидаемый результат
Разобраны размеры и ограничения собственного элемента управления.
На что обратить внимание
Не переносите значение 28 напрямую как 28px в HTML.
Шрифт, масштаб и клиент влияют на визуальный размер.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.