Настройка границы отрисовки объекта через свойство Clip

12.08.2017

В этой статье я бы хотел заострить ваше внимание на одном интересном свойстве объекта Text. Свойство Clip определяет будет ли отображаться текст, если он выходит за границы объекта. Если это свойство включено, то текст будет обрезаться согласно границам объекта. Если выключено – будет отображаться в полном объеме, как будто бы объект растянулся.

Давайте посмотрим на примере. Создадим простой отчет.  Например, я вывожу список категорий товаров с картинками:

Обратите внимание, что выделенный текстовый объект с названием категории имеет маленький размер. Я специально отключил перенос текста (свойство WordWrap) для наглядности.

Запустим отчет:

 

Как видим, названия категорий обрезаны из-за малого размера текстового объекта. А теперь, для этого же объекта установим свойство Clip в false (по умолчанию true).

 

Посмотрим, как теперь будет выглядеть отчет:

Названия отображаются полностью, несмотря на размер объекта Текст.

А теперь сделаем экспорт в формат PDF:

Документ соответствует отчету, все корректно.

Я пошел дальше, и решил отобразить текст вертикально. Для этого изменяем угол наклона объекта Текст в свойстве Angle, например - 270. Теперь объект Текст выглядит так:

Запускаем отчет:

На этот раз свойство не сработало. Но не все так плохо. Сделаем экспорт отчета в PDF:

А вот здесь, свойство Clip действительно отключено и текст выводится корректно, несмотря на размер текстового объекта.

Сделаем наклон текста в 45 градусов и повторим эксперимент. 

В отчете по-прежнему текст отображается не полностью. А теперь экспорт в PDF:

 

И на этот раз экспорт в PDF не подвел. Все выглядит корректно.

Подведем итог. Свойство текстового объекта Clip обрезает текст, который не помещается в границах объекта. Если использовать свойство авторасширения объекта под текст, это может подвинуть соседние объекты или привести к наложению объектов, что при некоторых экспортах приведет к некорректному отображению отчета. В таких случаях удобно отключать свойство Clip.

Из рассмотренного понятно, что сейчас эта «фича» работает только при горизонтальном выводе текста в отчетах. Однако при экспорте в PDF угол поворота текста значения не имеет. Текст всегда отображается целиком. 

.NET FastReport .NET FastReport
8 апреля 2025

Как настроить подключение к Apache Ignite в FastReport .NET

В этой статье мы рассмотрим, как настроить подключение к Apache Ignite в FastReport .NET. Вы узнаете, какие шаги необходимо выполнить для подключения плагина через код и дизайнер отчетов.
8 апреля 2025

Конвертер из формата Microsoft Word (.docx) в файл для FastReport .NET (.frx)

Конвертер из формата Microsoft Word (.docx) в файл для FastReport .NET (.frx): описание и инструкция по использованию инструмента.
25 марта 2025

Как объединить несколько отчетов в один из FastReport .NET

FastReport .NET — это мощный инструмент для создания и управления отчётами. В данной статье мы рассмотрим, как объединить несколько отчётов в один в FastReport .NET.