Table.Levels

Levels (Работа с уровнями)
Объект: Электронная таблица Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в число, неверный индекс. Визуальность: Да

• Начальная страница
• Общее описание
• Объекты
• Электронная таблица

Функция возвращает объект визуальных уровней таблицы. Уровни используются для выделения групп столбцов или строк таблицы. Уровни можно закрывать или открыть. Если уровень закрыт, строки или столбцы, входящие в него (кроме основной строки/столбца) будут скрыты. Уровни могут быть вложенными друг в друга. С объектом можно вызывать функции, типа Open и пр. Функция содержит указание на конкретный уровень (если заданы индексы), после чего к нему можно добавить дочерние уровни, либо указание на корневой уровень (если индексы не заданы).

Синтаксис

Table.Levels(<Тип уровня (INT)>=0,<Индекс уровня (INT)>,<Индекс дочернего уровня (INT)>...):<Визуальные уровни таблицы (TABLE.OPTIONS)>

Аргументы

• <Тип уровня (INT)> - (необязательный аргумент) Аргумент задает тип (измерение) получаемого объекта уровней, доступны следующие значения:
  • 0 (по умолчанию) -- вертикальные уровни
  • 1 -- горизонтальные уровни
• <Индекс уровня (INT)>,<Индекс дочернего уровня (INT)>... - (необязательный аргумент) Аргументы задают путь к нужному уровню по индексам уровней до него. Если аргументы не заданы, функция вернет самый верхний уровень.

Возвращаемое значение

Возвращает объект TABLE.OPTIONS.

Примеры

//Пример добавления вертикальных уровней в таблицу Т
While З.Next(1) Do
  ...
  //Вывод уровня 1
  Т.CopyByX("v2",1);
  ...

  //Запомним высоту строки "v2" уровня 1
  НачВыс:=Т.Height();
  While З.Next(2) Do
    ...
    //Вывод уровня 2
    Т.CopyByX("v3",1);
    ...
  EndDo;

  //Добавим вертикальный уровень, в который будет складываться строки "v3"
  Т.Levels(0).Add(0,НачВыс,Т.Height());
EndDo;

//Закроем добавленные уровни (кроме строк "v2") перед выводом таблицы на экран
Т.Levels(0).Close();