Функция «filterRows» показывает или скрывает строки в зависимости от параметра «show», если найдено соответствие шаблонов/образцов в столбце (см. описание ниже). |
Краткое описание
setValue(string shape, «filterRows», dyn_string columns, dyn_string patterns, bool show);shape.filterRows(dyn_string columns, dyn_string patterns, bool show); |
Параметры
Параметр | Описание |
shape | Имя объекта |
columns | Массив имен столбцов |
patterns | Массив образцов Синтаксис подобен функции patternMatch(). |
show | TRUE = Показать строку.FALSE = Скрыть строку. |
Описание
Параметр «columns» содержит массив имен столбцов, а параметр «patterns» такой же длинный массив образцов (которые используют синтаксис patternMatch()).Все ячейки выбранных столбцов во всех строках таблицы проверяются на соответствие образцу для столбцов и при нахождении соответствия строка либо будет отображаться (show = true), либо будет скрыта (show = false), в зависимости от аргумента «show». |
ПРИМЕР Будут показаны все строки в которых будет найдено соответствие по образцу «*A*» в столбце «#2″ и соответствие по образцу *B*» в столбце «#3». Все остальные строки будут скрыты. Значения ячеек форматируются (используя формат по умолчанию) в представление строки данных перед функцией «patternMatch», т.к. в таблице содержится внутренний тип данных, того что указано в ячейке (например, в таблице может находиться логическая переменная, отображаемая в ячейке в виде флажка, однако после преобразования, в строке данных будет слово «TRUE» или «FALSE»). Результат преобразования будет таким же, как назначение типа данных переменной типа «строка» (например, string s = (bool)b). |
main() { TABLE1.filterRows(makeDynString(«#2», «#3»), makeDynString(«*A*», «*B*»), true); } |
ПРИМЕЧАНИЕ
Если обе динамических строки данных «columns» и «patterns» пустые, во всех строках будет найдено соответствие, а если:
table.filterRows(makeDynString(), makeDynString(), true) => будут показаны все строки.
table.filterRows(makeDynString(), makeDynString(), true) => будут скрыты все строки.
ПРИМЕЧАНИЕ
Это однократное действие. Таблица не сохраняет критерии фильтра. Таким образом, при последующем добавлении новых строк, они будут показаны независимо от совпадения с образцами ранее.
Используется для объекта:
Таблица |
См. также