Тип: Строка. Содержит имя шрифта, если оно задано (например, "Times New Roman").
Полное описание, параметры и ограничения
Шрифт.Имя (Font.Name)
Шрифт (Font)
Имя (Name)
Доступен, начиная с версии 8.0.
Использование:
Только чтение.
Описание:
Тип: Строка.
Содержит имя шрифта, если оно задано (например, "Times New Roman").
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Если шрифт задан не абсолютным, то содержит пустую строку.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Сделать заголовочный шрифт из базового без изменения оригинала
Шрифт хранит параметры начертания только для чтения. Новый шрифт из исходного меняет размер и жирность, сохраняя остальные явно заданные параметры.
Где и как запускать
В учебной управляемой форме создайте команду УчебныйПример и кнопку для неё. Назначьте обработчик действия УчебныйПример. Приведённую процедуру целиком вставьте в модуль формы. Не вставляйте её внутрь другой процедуры. Запустите форму в тонком или толстом клиенте Windows.
Подготовка
Создайте отдельную учебную обработку с управляемой формой; рабочие печатные формы не изменяйте.
ТабличныйДокумент.Показать открывает окно просмотра, но не отправляет документ на физический принтер.
Используйте платформу 8.5.1.1343: ПолучитьАбсолютный существует начиная с 8.3.23.
Если Arial не установлен, клиент может подобрать замену; контролируем параметры объекта отдельно от фактической отрисовки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ПоУмолчанию = Новый Шрифт;
Базовый = Новый Шрифт("Arial", 10, Ложь, Ложь, Ложь, Ложь, 100);
Заголовочный = Новый Шрифт(Базовый, , 14, Истина);
Абсолютный = Заголовочный.ПолучитьАбсолютный();
Сообщить(Базовый.Имя = "Arial");
Сообщить(Базовый.Размер = 10 И Не Базовый.Полужирный);
Сообщить(Заголовочный.Размер = 14 И Заголовочный.Полужирный);
Сообщить(Не Заголовочный.Наклонный);
Сообщить(Не Заголовочный.Подчеркивание);
Сообщить(Не Заголовочный.Зачеркивание);
Сообщить(Заголовочный.Масштаб = 100);
Сообщить("Вид шрифта по умолчанию: " + Строка(ПоУмолчанию.Вид));
Сообщить("Вид абсолютного шрифта: " + Строка(Абсолютный.Вид));
Сообщить("Абсолютный шрифт: " + Абсолютный.Имя);
ТабДок = Новый ТабличныйДокумент;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Область(, 1, , 1).ШиринаКолонки = 55;
ТабДок.Область(1, 1).Текст = "Базовый: 10 пунктов, обычный";
ТабДок.Область(1, 1).Шрифт = Базовый;
ТабДок.Область(2, 1).Текст = "Заголовок: 14 пунктов, полужирный";
ТабДок.Область(2, 1).Шрифт = Заголовочный;
ТабДок.Область(3, 1).Текст = "Оформление по умолчанию";
ТабДок.Область(3, 1).Шрифт = ПоУмолчанию;
ТабДок.Область(1, 1, 3, 1).ВысотаСтроки = 30;
ТабДок.Показать("Три варианта шрифта");
КонецПроцедурыРазбор по шагам
Шрифт без параметров зависит от оформления. Базовый имеет семь явных параметров: имя, размер, четыре начертания и масштаб.
В конструкторе на основании другого шрифта первый аргумент — Шрифт, затем имя, размер и жирность. Пропущенное имя сохраняется.
Проверяем, что исходный Базовый остался 10/обычный, а Заголовочный стал 14/полужирный.
Наклонный, Подчеркивание, Зачеркивание и Масштаб унаследованы из явной базы.
ПолучитьАбсолютный возвращает значение с определённым системным именем. Он не устанавливает шрифт в Windows.
Как проверить результат
Контроль исходного и нового шрифтов — Истина; масштаб равен 100, три дополнительные начертания выключены.
В окне второй текст крупнее и полужирный, первый остаётся обычным.
Третья строка использует оформление по умолчанию и не обязана совпадать с Arial 10.
Ожидаемый результат
Созданы независимые значения шрифтов с видимым сравнением и проверкой неизменности оригинала.
На что обратить внимание
Попытка Заголовочный.Размер = 14 неверна: Размер доступен только для чтения; нужен новый Шрифт.
Пропуск параметра и явное Ложь — разные решения при наследовании настроек.
Не путайте Размер в пунктах, Масштаб в процентах и высоту строки документа.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Установить шрифт важной надписи, сохранив наследуемые параметры
ВажнаяНадписьШрифт наследует NormalTextFont и задаёт полужирное начертание. Используем готовое значение, а не угадываем имя и размер шрифта на компьютере.
Где и как запускать
Полный модуль собственной обычной формы внешней обработки; толстый клиент учебной копии.
Подготовка
Только отдельная учебная копия КА2 Progress. Три существующих элемента: АктуальнаяПодпискаЦвет, ВажнаяНадписьШрифт, РамкаОдинарнаяЭПД. Их виды и исходные значения проверены по StyleItems/*.xml, не придуманы.
Для визуальных уроков создайте собственную внешнюю обработку с обычной формой, пустой панелью УчебнаяПанель и кнопкой вне панели. Назначьте кнопке действие ВыполнитьПример. Вставьте полный модуль урока в модуль этой обычной формы; обработчик без аргументов.
Запускайте обычную форму в толстом клиенте учебной копии. В управляемой форме нет ЭлементыФормы и объекта Панель; туда код обычного визуального урока не переносится.
Серверные диагностические уроки отдельно размещаются в серверном общем модуле УчебныеЗадачи. Код не меняет метаданные, ГлавныйСтиль, основной стиль базы или оформление рабочих форм.
Процедура ВыполнитьПример()
Описание = Метаданные.ЭлементыСтиля.Найти("ВажнаяНадписьШрифт");
Если Описание = Неопределено Тогда
ВызватьИсключение "Проверьте имя элемента стиля в учебной копии КА2 Progress";
КонецЕсли;
Варианты = Метаданные.СвойстваОбъектов;
Если Описание.Вид <> Варианты.ВидЭлементаСтиля.Шрифт Тогда
ВызватьИсключение "Для Шрифт нужен элемент вида Шрифт";
КонецЕсли;
ШрифтПанели = Описание.Значение;
Если ТипЗнч(ШрифтПанели) <> Тип("Шрифт") Тогда
ВызватьИсключение "Ожидалось готовое значение Шрифт";
КонецЕсли;
ЭлементыФормы.УчебнаяПанель.Шрифт = ШрифтПанели;
Сообщить(ШрифтПанели.Полужирный = Истина);
Сообщить(ТипЗнч(ЭлементыФормы.УчебнаяПанель.Шрифт) = Тип("Шрифт"));
Сообщить("Имя фактического шрифта: " + ШрифтПанели.Имя);
Сообщить("Размер фактического шрифта: " + Строка(ШрифтПанели.Размер));
КонецПроцедурыРазбор по шагам
В XML указан вид Font и ссылка на NormalTextFont с bold=true. Имя и размер не зафиксированы этой ссылкой как универсальные Arial/12.
Получаем готовое значение после проверки вида и типа. Его можно назначить свойству Шрифт обычной панели.
Полужирный проверяем как явное исходное переопределение. Имя и Размер показываем как фактические параметры, без выдуманной константы.
Чтобы оценить шрифт на экране, перед запуском добавьте в свою панель простую надпись Книга. Не выводите туда данные рабочей формы.
Как проверить результат
Две проверки — Истина для исходного элемента. Надпись своей обычной панели можно сравнить до и после нажатия кнопки.
Данные базы не записаны, набор установленных шрифтов ОС не изменён.
Ожидаемый результат
Показано использование готового шрифта конфигурации с наследованием и явным переопределением начертания.
На что обратить внимание
Это пример обычной формы. Поведение шрифтов управляемого интерфейса 8.5 рассматривается отдельно.
Нельзя считать ссылку NormalTextFont обещанием одинакового имени и размера на любых компьютерах.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.