Текстовое поле: различия между версиями

Текущая версия от 03:54, 3 марта 2026

Текстовое поле (TextBox) — это наиболее часто используемый элемент управления отчётом, который отображает текстовые данные в любом отчёте.

Общие сведения

выражение в текстовом поле может отображать поля из базы данных, вычислять значение или визуально отображать данные;
в отчётах текстовое поле по умолчанию отображается в каждой ячейке области данных Table (Таблица) или Tablix (Табликс);
чтобы ввести текст непосредственно в текстовое поле, просто дважды щёлкните внутри элемента управления на поверхности конструктора отчёта.

Создание текстового поля

для добавления текстового поля необходимо в левой части окна Дизайнера (рис. 3.1) левой кнопкой мыши нажать на элемент TextBox и, не отпуская, перенести его в желаемое место (не обязательно точно, хотя бы в желаемый раздел, расположение элемента позже можно будет откорректировать), в данном случае – в верхнюю левую часть верхнего колонтитула;

В результате созданный текстовый элемент появится

в верхней левой части верхнего колонтитула (рис. 3.2)

в дереве отчета (рис. 3.3);

по умолчанию имя элемента создается в формате TextBoxN, где N автоматически посчитанный порядковый номер текстового элемента в данном отчете.

Изменение имени текстового поля

для изменения имени текстового поля необходимо внести изменения в двух свойствах текстового элемента – Data >> DataElementName и Design >> (Name).

Изменение шрифта

для изменения свойств шрифта текстового поля в свойствах текстового элемента разворачиваем вкладку Appearance >> Font;

для изменения названия шрифта нажимаем на наименование свойства или значение свойства Appearance >> Font >> FontFamily, после чего нажимаем стрелку меню и выбираем название шрифта;

аналогично выбирается размер шрифта (вкладка Appearance >> Font >> FontSize;

аналогично выбирается стиль шрифта (вкладка Appearance >> Font >> FontStyle – нормальный (Normal) или курсив (Italic);

аналогично выбирается толщина шрифта (вкладка Appearance >> Font >> FontWeight – нормальный (Normal), жирный (Bold) и другие.

Выравнивание текста

для выравнивания текста по горизонтали используется вкладка Appearance >> Font >> TextAlign;

для выравнивания текста по вертикали используется вкладка Appearance >> Font >> VerticalAlign.

Выравнивание текста по условию

Для выравнивания текста по условию:

в свойстве текстового поля Appearance >> Font >> TextAlign (или VerticalAlign) выбрать <Expression...>;
ввести формулу вида =IIF(ReportItems!name_cell.Value = "-", "Center", "Left"), где

name_cell - имя текстового поля,
- - значение, при котором происходит фильтрация,
Center - тип центровки при соблюдении условия,
Left - тип центровки при несоблюдении условия.

Свойства Layout

AutoMergeMode

Определяет режим автоматического объединения ячеек с одинаковыми значениями в отчете:

Never - по умолчанию, никогда не объединяются
Always - всегда объединяются
Restricted - объединяются только в том случае, если соответствующие ячейки в предыдущих столбцах объединены аналогичным образом – Always или Restricted.

Примечание: подробней в разделе таблиц.

CanGrow

Указывает, может ли текстовое поле увеличиваться в высоту, чтобы вместить весь текст, если он не помещается в исходные границы:

true - увеличивается в высоту.

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

false - не увеличивается в высоту.

Примечание: при использовании для текстового поля, как одного из ячеек таблицы, если соседние ячейки будут меньше по высоте - ячейка и текст в ней будут обрезаться под окружающую высоту.

CanShrink

Определяет, может ли поле уменьшаться в высоту, если данных в нем меньше, чем позволяет его размер в дизайнере. Это полезно для удаления пустых строк или лишнего пространства.

KeepTogether

Если установлено значение true, система попытается напечатать всё содержимое текстового поля на одной странице. Если поле не помещается на текущей странице, оно будет целиком перенесено на следующую.

MinCondenseRate

Задает минимальный коэффициент (в процентах), до которого текст может быть горизонтально сжат (уплотнен), чтобы уместиться в ширину поля без переноса на новую строку. Значение 100 означает отсутствие сжатия.

ShrinkToFit

Если включено (true), размер шрифта будет автоматически уменьшаться, чтобы текст полностью поместился в фиксированные границы элемента управления. Важно: Если это свойство активно, настройка CanGrow игнорируется.

@@ Строка 8: / Строка 8: @@
 ==Создание текстового поля==
 *для добавления текстового поля необходимо в левой части окна Дизайнера (рис. 3.1) левой кнопкой мыши нажать на элемент <code>TextBox</code> и, не отпуская, перенести его в желаемое место (не обязательно точно, хотя бы в желаемый раздел, расположение элемента позже можно будет откорректировать), в данном случае – в верхнюю левую часть верхнего колонтитула;
-*в результате созданный текстовый элемент появится в верхней левой части верхнего колонтитула (рис. 3.2) и в дереве отчета (рис. 3.3);
+[[Файл:Text.png|center|thumb]]
+В результате созданный текстовый элемент появится
+*в верхней левой части верхнего колонтитула (рис. 3.2)
+[[Файл:Text2.png|center|thumb]]
+*в дереве отчета (рис. 3.3);
+[[Файл:Text3.png|center]]
 *по умолчанию имя элемента создается в формате <code>TextBoxN</code>, где <code>N</code> автоматически посчитанный порядковый номер текстового элемента в данном отчете.
 ==Изменение имени текстового поля==
-*для изменения имени текстового поля необходимо внести изменения в двух свойствах текстового элемента – <code>Data >> DataElementName</code> и <code>Design >> (Name)</code> (рис. 3.4).
+*для изменения имени текстового поля необходимо внести изменения в двух свойствах текстового элемента – <code>Data >> DataElementName</code> и <code>Design >> (Name)</code>.
+[[Файл:Text.png|center|thumb]]
 ==Изменение шрифта==
-*для изменения свойств шрифта текстового поля в свойствах текстового элемента разворачиваем вкладку <code>Appearance >> Font</code> (рис. 3.5);
+*для изменения свойств шрифта текстового поля в свойствах текстового элемента разворачиваем вкладку <code>Appearance >> Font</code>;
-*для изменения названия шрифта нажимаем на наименование свойства или значение свойства <code>Appearance >> Font >> FontFamily</code>, после чего нажимаем стрелку меню (рис. 3.6) и выбираем название шрифта;
+[[Файл:Text5.png|center]]
-*аналогично выбирается размер шрифта (вкладка <code>Appearance >> Font >> FontSize</code> (рис. 3.7);
+*для изменения названия шрифта нажимаем на наименование свойства или значение свойства <code>Appearance >> Font >> FontFamily</code>, после чего нажимаем стрелку меню и выбираем название шрифта;
-*аналогично выбирается стиль шрифта (вкладка <code>Appearance >> Font >> FontStyle</code> (рис. 3.8) – нормальный (<code>Normal</code>) или курсив (<code>Italic</code>);
+[[Файл:Text6.png|center]]
-*аналогично выбирается толщина шрифта (вкладка <code>Appearance >> Font >> FontWeight</code> (рис. 3.9) – нормальный (<code>Normal</code>), жирный (<code>Bold</code>) и другие.
+*аналогично выбирается размер шрифта (вкладка <code>Appearance >> Font >> FontSize</code>;
+[[Файл:Text7.png|center]]
+*аналогично выбирается стиль шрифта (вкладка <code>Appearance >> Font >> FontStyle</code> – нормальный (<code>Normal</code>) или курсив (<code>Italic</code>);
+[[Файл:Text8.png|center]]
+*аналогично выбирается толщина шрифта (вкладка <code>Appearance >> Font >> FontWeight</code> – нормальный (<code>Normal</code>), жирный (<code>Bold</code>) и другие.
+[[Файл:Text9.png|center]]
 ==Выравнивание текста==
-*для выравнивания текста по горизонтали используется вкладка <code>Appearance >> Font >> TextAlign</code> (рис. 3.10);
+*для выравнивания текста по горизонтали используется вкладка <code>Appearance >> Font >> TextAlign</code>;
-*для выравнивания текста по вертикали используется вкладка <code>Appearance >> Font >> VerticalAlign</code> (рис. 3.11).
+[[Файл:Text10.png|center]]
+*для выравнивания текста по вертикали используется вкладка <code>Appearance >> Font >> VerticalAlign</code>.
+[[Файл:Text11.png|center]]
+===Выравнивание текста по условию===
+Для выравнивания текста по условию:
+*в свойстве текстового поля <code>Appearance >> Font >> TextAlign</code> (или <code>VerticalAlign</code>) выбрать <code><Expression...></code>;
+*ввести формулу вида <code>=IIF(ReportItems!name_cell.Value = "-", "Center", "Left")</code>, где
+::*<code>name_cell</code> - имя текстового поля,
+::*<code>-</code> - значение, при котором происходит фильтрация,
+::*<code>Center</code> - тип центровки при соблюдении условия,
+::*<code>Left</code> - тип центровки при несоблюдении условия.
+==Свойства Layout==
+===AutoMergeMode===
+Определяет режим автоматического объединения ячеек с одинаковыми значениями в отчете:
+*<code>Never</code> - по умолчанию, никогда не объединяются
+*<code>Always</code> - всегда объединяются
+*<code>Restricted</code> - объединяются только в том случае, если соответствующие ячейки в предыдущих столбцах объединены аналогичным образом – <code>Always</code> или <code>Restricted</code>.
+Примечание: [[Таблица#Объединение соседних ячеек с одинаковыми значениями|подробней в разделе таблиц]].
+===CanGrow===
+Указывает, может ли текстовое поле увеличиваться в высоту, чтобы вместить весь текст, если он не помещается в исходные границы:
+*<code>true</code> - увеличивается в высоту.
+:''Примечание: при использовании для текстового поля, как одного из ячеек таблицы, вся строка будет выравниваться по самой высокой из ячеек.''
+[[Файл:cangrow1.png|center]]
+*<code>false</code> - не увеличивается в высоту.
+:''Примечание: при использовании для текстового поля, как одного из ячеек таблицы, если соседние ячейки будут меньше по высоте - ячейка и текст в ней будут обрезаться под окружающую высоту.''
+[[Файл:cangrow2.png|center]]
+===CanShrink===
+Определяет, может ли поле уменьшаться в высоту, если данных в нем меньше, чем позволяет его размер в дизайнере. Это полезно для удаления пустых строк или лишнего пространства.
+===KeepTogether===
+Если установлено значение <code>true</code>, система попытается напечатать всё содержимое текстового поля на одной странице. Если поле не помещается на текущей странице, оно будет целиком перенесено на следующую.
+===MinCondenseRate===
+Задает минимальный коэффициент (в процентах), до которого текст может быть горизонтально сжат (уплотнен), чтобы уместиться в ширину поля без переноса на новую строку. Значение 100 означает отсутствие сжатия.
+===ShrinkToFit===
+Если включено (<code>true</code>), размер шрифта будет автоматически уменьшаться, чтобы текст полностью поместился в фиксированные границы элемента управления. Важно: Если это свойство активно, настройка <code>CanGrow</code> игнорируется.
+[[Category:Внутренняя документация]]
+[[Category:Тритея]]
+[[Category:Дизайнер_документов]]