Сортировка таблицы по столбцам.

Краткое описание

setValue(string shape, «sort», [bool/dyn_bool ascending = true], string Name1 [, string Name2 …]);

shape.sort([bool ascending = true], string Name1 [, string Name2 …]);

Parameters (Параметры)

Параметр	Описание
shape	Имя объекта
ascending	TRUE (ИСТИНА) = сортировка по возрастанию FALSE (ЛОЖЬ) = сортировка по убыванию   Так же можно сортировать несколько столбцов, для каждой из которых может быть задан свой порядок сортировки. Для этого используйте параметр dyn_bool. См. пример ниже..
Имя	Имена столбцов

Описание

ПРИМЕЧАНИЕ

Для возможности сортировки все элементы столбца должны быть одного типа данных. Данные Langtext сортируются в соответствии с активным языком, при этом онлайн-переключатель языков может вызывать проблемы, т.к. массивы считаются отсортированными, но на самом деле нет.

Параметрами являются имена столбцов, которые необходимо отсортировать в определенном порядке. Далее таблица будет отсортирована по значениям ячеек.
Если сортировка по параметру первого столбца не возвращает четкий порядок сортировки, спорные случаи разрешаются на основании параметра второго (третьего или четвертого) столбца.

Строки столбцов, которые сортируются по меньшему значению помещаются перед строками с большими значениями. Строки сортируются по коду ASCII.

ПРИМЕЧАНИЕ

В связи с тем, что функция «sort»при использовании совместно с setMultiValue() может использовать любое количество параметров, ееследует использовать только в качестве последнего параметра.

ПРИМЕЧАНИЕ Сортировка не работает в том случае, если после функции «sort» для таблицы вызывается одна из следующих функций: appendLineappendLinesinsertLineNinsertLinesNcellValue  (только если функцией cellValue было установлено значение в отсортированном столбце)cellValueRC  (только если функцией cellValueRC было установлено значение в отсортированном столбце) ПРИМЕР

На следующем примере выполняется сортировка таблицы по столбцам»Last name», «First name» и «Age». Если значения в столбце «Surname» (Фамилия) совпадают, таблица будет дополнительно отсортирована по столбцу «First name» (Имя). Если значения совпадают в столбцах «Surname» и «First name», последним критерием сортировки будет столбец «Age» (Возраст).

main()  {            table.sort(«Surname», «First name», «Age»);  }

На примере ниже таблица сортируется по трем столбцам, первый столбец по убыванию а две следующие по возрастанию.

main()  {    dyn_bool sort;       sort[1] = 0;    sort[2] = 1;    sort[3] = 1;        TABLE1.sort(sort,»#1″,»#2″,»#3″);  }

Используется для объекта

Таблица

См. также

«sortDyn», «sortOnClick», «sortOrig», «sortPart», «sortUndo»