Работа со списком переменных

Переменные были подробно рассмотрены в соответствующей главе руководства пользователя. Кратко напомним суть. В отчете можно определить одну или несколько переменных. Каждой переменной можно присвоить значение или выражение, которое будет автоматически вычисляться при обращении к переменной. Переменные можно визуально вставлять в отчет, пользуясь окном "Дерево данных". Переменные удобно использовать для замещения сложных выражений, которые часто используются в отчете.

Для работы с переменными необходимо использовать модуль frxVariables. Переменная представлена классом TfrxVariable.

TfrxVariable = class(TCollectionItem)

published

   property Name: String;

Имя переменной

   property Value: Variant;

Значение переменной

end;

Список переменных представлен классом TfrxVariables. Он содержит все необходимые методы для работы со списком.

TfrxVariables = class(TCollection)

public

   function Add: TfrxVariable;

Добавляет переменную в конец списка

   function Insert(Index: Integer): TfrxVariable;

Добавляет переменную в указанную позицию списка

   function IndexOf(const Name: String): Integer;

Возвращает индекс переменной с заданным именем

   procedure AddVariable(const ACategory, AName: String; const AValue: Variant);

Добавляет переменную в заданную категорию

   procedure DeleteCategory(const Name: String);

Удаляет категорию и все ее переменные

   procedure DeleteVariable(const Name: String);

Удаляет переменную

   procedure GetCategoriesList(List: TStrings; ClearList: Boolean = True);

Возвращает список категорий

   procedure GetVariablesList(const Category: String; List: TStrings);

Возвращает список переменных в заданной категории

   property Items[Index: Integer]: TfrxVariable readonly;

Список переменных

   property Variables[Index: String]: Variant; default;

Значения переменных

end;

Если список переменных велик, удобно сгруппировать его по категориям. Например, имея список переменных:

название предприятия

р/счет

итого

итого ндс

мы можем представить его в виде:

Реквизиты

название предприятия

р/счет

Итоги

итого

итого ндс

Имеются следующие ограничения:

- обязательно наличие хотя бы одной категории

- категории образуют первый уровень дерева данных, переменные - второй

- категории не могут быть вложенными

- имена переменных должны быть уникальны в пределах всего списка, а не в пределах категории