Table.NavigationState

From SunFlurry wiki
Jump to: navigation, search
  NavigationState (Параметры навигации таблицы)
Объект:Электронная таблица
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку
Визуальность:Да

Функция возвращает или/и изменяет состояние навигации в таблице. В это понятие включается: первая видимая верхняя левая ячейка, количество закрепленных строк и столбцов, положение курсора в таблице. Сохранение и восстановление состояния, к примеру, удобно использовать при обновлении отчета, чтобы после обновления вернуть курсор в ячейку, в которой он находился до обновления. Не рекомендуется разбирать строку состояния программно, так как формат строки может измениться в будущем.

Синтаксис

Table.NavigationState(<Новое состояние навигации (STRING)>):<Текущее состояние навигации (STRING)>

Аргументы

  • <Новое состояние навигации (STRING)> - (необязательный аргумент) Задает новое состояние навигации, которое будет применено во время выполнения функции. Если аргумент не задан, свойства таблицы изменены не будут.

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

Возвращает строку -- текущее состояние навигации в таблице.

Примеры

Т:=Form.Таблица.Value;
Нави:=?(Обновление=0,"",Т.NavigationState());
Т.Lock();
Try
  Т.Clear();
    
  //Обновление таблицы
  ...

  Т.Levels(0).Close();
  Т.Options.LevelsVisible:=оУровни;
Finally
  Т.NavigationState(Нави);
  Т.Unlock();
  Т.Update();
EndTry;