КнопкаФормы.ВысотаКартинки

Свойства · PictureHeight

Тип: Число. Высота картинки. Если высота кнопки задана, то: если высота картинки задана, то она не может быть больше высоты кнопки с учетом текста и отступов, если высота картинки - 0, то картинка вписывается в доступную для нее высоту. Если высота кнопки не задана, то: если высота картинки задана, то картинка выводится заданной высоты, пропорционально уменьшаясь или увеличиваясь. Размер кнопки при этом подстраивается под картинку; если высота картинки - 0, то картинка выводится оригинального размера. Размер кнопки при этом подстраивается под картинку.

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

КнопкаФормы.ВысотаКартинки (FormButton.PictureHeight)

КнопкаФормы (FormButton)

ВысотаКартинки (PictureHeight)

Применяется только в интерфейсе «Версия 8.5»

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

Использование:
Чтение и запись.
Описание:
Тип: Число.
Высота картинки.

Если высота кнопки задана, то:
если высота картинки задана, то она не может быть больше высоты кнопки с учетом текста и отступов,

если высота картинки - 0, то картинка вписывается в доступную для нее высоту.

Если высота кнопки не задана, то:
если высота картинки задана, то картинка выводится заданной высоты, пропорционально уменьшаясь или увеличиваясь. Размер кнопки при этом подстраивается под картинку;

если высота картинки - 0, то картинка выводится оригинального размера. Размер кнопки при этом подстраивается под картинку.

Доступность:

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

Примечание:
Свойство применяется только для кнопок, отображаемых как карточка. В других случаях значение игнорируется.
Использование в версии:

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

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

Применяется только в интерфейсе «Версия 8.5»

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

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

Добавить собственную SVG-картинку рядом с текстом кнопки

Картинка галочки задана прямо в коде. Нет файла, общего рисунка конфигурации или скачивания изображения.

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

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

Подготовка

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

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

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

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

  5. Кнопка и команда УчебноеДействие создаются программно. Не добавляйте их вручную: имена должны оставаться уникальными.

  6. Проверяйте в установленной платформе 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, Ложь);
    УчебнаяКартинка = Новый Картинка(Байты);
    КомандаДействия.Картинка = УчебнаяКартинка;
    Кнопка.Картинка = УчебнаяКартинка;
    Кнопка.Отображение = ОтображениеКнопки.КартинкаИТекст;
    Кнопка.ПоложениеКартинки = ПоложениеКартинкиКнопкиФормы.Лево;
    Кнопка.ВысотаКартинки = 2;
    Кнопка.ВысотаЗаголовка = 0;
    Сообщить(ТипЗнч(Кнопка.Картинка) = Тип("Картинка"));
    Сообщить(Кнопка.Отображение = ОтображениеКнопки.КартинкаИТекст);
    Сообщить(Кнопка.ПоложениеКартинки = ПоложениеКартинкиКнопкиФормы.Лево);
    Сообщить(Кнопка.ИмяКоманды = "УчебноеДействие");
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
    Сообщить(СтрШаблон("Учебных строк: %1; общее количество: %2",
        ЭтаФорма.Товары.Количество(), ЭтаФорма.Товары.Итог("Количество")));
КонецПроцедуры

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

  1. Собственный SVG переводим в UTF-8-байты и создаём Картинка из этих данных.

  2. КартинкаИТекст сохраняет понятную подпись, не заставляет новичка угадывать назначение значка.

  3. ВысотаКартинки и ВысотаЗаголовка настраиваются отдельно; 0 у заголовка означает автоматический размер.

  4. Размер файла картинки 32×32 не означает размер кнопки в пикселях.

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

  1. Четыре сравнения Истина: картинка, режим, положение и прежняя команда.

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

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

Собственная иконка связана с действующей командой без внешних ресурсов.

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

  1. SVG не содержит ссылок, script или внешних ресурсов; не подставляйте произвольную внешнюю разметку.

  2. Не заменяйте понятный текст одной картинкой для важной команды без необходимости.

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

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

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

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

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