IPrxSheetHeaderPart.Text

Синтаксис

Text: String;

Описание

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

Комментарии

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

Подстановка/тег Описание
&[Page] В текущую позицию будет выведен номер текущей страницы.
&[Pages] В текущую позицию будет выведено количество страниц текущего отчета.
&[Date] В текущую позицию будет выведена текущая дата.
&[Time] В текущую позицию будет выведено текущее время.
&[Name] В текущую позицию будет выведено название отчета.
&[Sheet.Page] В текущую позицию будет выведен номер страницы на текущем листе.
&[Sheet.Pages] В текущую позицию будет выведено количество страниц текущего листа отчета.
&[Picture] Использование изображения в текущей позиции.
&[Globals.<Идентификатор переменной>] В текущую позицию будет выведено значение глобальной переменной.
&[<Идентификатор среза>.Selection] В текущую позицию будет выведена отметка по фиксированным измерениям среза.
&[<Идентификатор среза>.<Идентификатор справочника>.Selection] В текущую позицию будет выведена отметка заданного измерения.
&[<Идентификатор листа>.<Идентификатор элемента управления>.Value] В текущую позицию будет выведено значение элемента управления. Идентификатор листа в теге может быть пропущен, в случае если элемент управления доступен для всех листов.

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

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

Примеры тегов:

&[Срез1.Selection Part = "Columns" Format = "Name: Value"]

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

&[ITEM1.Value Format = "Name: Value"]

В текущую позицию будет выведено наименование элемента управления, затем его значение.

&[Срез1.D_TO.Selection Format = "Name: Value"]

В текущую позицию будет выведено наименование заданного измерения, затем его отметка.

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

Пример

Для выполнения примера предполагается наличие в репозитории регламентного отчета с идентификатором «Report_1».

Sub UserProc;
Var
    MB: IMetabase;
    Report: IPrxReport;
    Header: IPrxReportTitle;
    HeaderPart: IPrxSheetHeaderPart;
Begin
    MB := MetabaseClass.Active;
    Report := MB.ItemById("Report_1").Edit As IPrxReport;
    Header := Report.Title;
    HeaderPart := Header.Center;
    HeaderPart.Text := "&[Name] &[Date]";
    HeaderPart.Color := GxColor.FromName("Blue");
    (Report As IMetabaseObject).Save;
End Sub UserProc;

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

См. также:

IPrxSheetHeaderPart