Текстовые метки

Настройка автозаполнения текстовой метки значениями атрибута

Текстовые метки на XPS-документе при его создании можно автоматически заполнять значениями атрибутов. Например, это может быть использовано для наложения регистрационного номера, времени создания документа и т.д. Для этого необходимо произвести настройку типа в Pilot-myAdmin:

Откройте вкладку Типы в базе данных Pilot-myAdmin.
Выберите тип и нажмите Редактировать в панели инструментов или контекстном меню.
В появившемся окне Редактирование типа в поле Дополнительные параметры вставьте описание конфигурации. Например:

                    <Configuration>
    <TextBlock
        Canvas.Top="20"
        HorizontalAlignment="Center"
        FontFamily="Arial">
            Произвольный текст: {attribute_name}
    </TextBlock>
</Configuration>
                

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

В текстовую метку можно выводить значения справочников. Для этого создайте атрибут типа Справочник элементов и укажите имя этого атрибута в {attribute_name} в настройке текстовой метки.

Несколько текстовых меток в одном документе

На одном документе можно создать несколько текстовых меток. В этом случае текст будет выглядеть следующим образом:

                <Configuration>
    <TextBlock HorizontalAlignment="Left">
        Произвольный текст 1: {attribute_name_1}
    </TextBlock>
    <TextBlock HorizontalAlignment="Right">
        Произвольный текст 2: {attribute_name_2}
    </TextBlock>
</Configuration>
            

Для того, чтобы метки не накладывались друг на друга используется форматирование текста. В приведённом примере метки разнесены по углам листа с помощью горизонтального выравнивания аттрибутом HorizontalAlignment.

Несколько атрибутов в одной метке

В одной текстовой метке можно отображать сразу несколько атрибутов. В этом случае текст будет выглядеть так:

                <Configuration>
    <TextBlock>
        Произвольный текст 1: {attribute_name_1} <LineBreak/>
        Произвольный текст 2: {attribute_name_2}
    </TextBlock>
</Configuration>
            

Тег - <LineBreak/> используется для перевода строки внутри текстовой метки.

Стилизация и форматирование текста

Для стилизации и форматирования текста можно задавать следующие параметры:

Параметр	Описание	Значение
Width	Ширина текстовой метки	Числовое значение
TextWrapping	Перенос текста при заданной ширине текстовой метки. По умолчанию текст обрезается.	Wrap (по умолчанию); NoWrap
FontSize	Размер шрифта	Числовое значение
FontFamily	Шрифт текстовой метки	Название семейства шрифта
Angle	Угол поворота текста	от 0 до 360°
HorizontalAlignment	Выравнивание текста по горизонтали относительно страницы	Left; Center; Right
VerticalAlignment	Выравнивание текста по вертикали относительно страницы	Top; Center; Bottom
Canvas.Top	Cмещение по вертикали от текущего выравнивания	Числовое значение со знаком "+" или "—"
Canvas.Left	Смещение по горизонтали от текущего выравнивания	Числовое значение со знаком "+" или "—"
Floating	Параметр определяет, будут ли текстовые метки встраиваться в итоговоый документ при наличии запроса на подпись или подписи без запроса.	True — при наличии запроса на подпись или подписи без запроса текстовая метка не будет встраиваться (плавающая текстовая метка); False — при наличии запроса на подпись или подписи без запроса текстовая метка будет встраиваться (по умолчанию).
HideIfEmptyValue	Параметр скрывает текстовую метку на документе, если значение атрибута не заполнено.	True — текстовая метка незаполненного атрибута скрыта; False — в текстовой метке отображается название атрибута (по умолчанию).
PageRange	Параметр задаёт номер, список номеров или диапазон страниц, на которые будут накладываться текстовые метки.	Числовое значение, список или диапазон значений. Возможные варианты задания диапазона страниц: 1,2,4 — метки будут наложены на страницы 1,2,4; 1-4 — на страницы с 1-ой по 4-ю; 1-3,6-8 — с 1 по 3-ю, с 6-ой по 8-ю страницы; 1,2,4-5 — на 1-ю, 2-ю и с 4-ой по 5-ю включ.; 3- — с 3-ей страницы по последнюю.
KeepWithinPageBounds	Параметр позволяет управлять ограничением размещения текстовой метки. По умолчанию текстовые метки могут выходить за границы документа. Благодаря этому, текстовую метку, для которой задан угол поворота отличный от 0°, можно расположить у края страницы.	False — текстовая метка может выходить за границы документа (по умолчанию); True — текстовая метка не может выходить за границы документа.

Единицы измерения параметров

По умолчанию, все значения, относящиеся к расположению и размерам элементов, задаются в пикселях. Кроме того, значения можно задавать в:

дюймах — in;
сантиметрах — cm;
точках — pt.

Чтобы задать значения в этих единицах измерения, допишите к числовому значению параметра обозначение единицы измерения, например:

                <Configuration>
    <TextBlockCanvas.Top="2.5cm"
        HorizontalAlignment="Center"
        FontFamily="Arial">
            Произвольный текст: {attribute_name}
    </TextBlock>
</Configuration>
            

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

Текстовая метка с временем создания документа

Чтобы автоматически наложить время создания документа задайте следующую настройку с использованием системного атрибута creation_time:

                <Configuration>
    <TextBlockCanvas.Top="2cm"
        HorizontalAlignment="Center"
        FontFamily="Arial">
            Дата создания: {creation_time}
    </TextBlock>
</Configuration>
            

Чтобы задать системному атрибуту creation_time формат даты и времени, отличный от формата, определённого по умолчанию, добавьте описание к атрибуту, например:

{creation_time:d/M/yyyy HH:mm}

Подробнее см. Атрибут Дата и время.