Фильтр диапазона

Eng: Filter Range

Элемент устанавливает один или несколько фильтров в заданном диапазоне ячеек Excel. Фильтр не поддерживает операторы сравнений, фильтрация осуществляется по совпадению значения со значением, указанным в фильтре. Использование фильтра позволяет отобразить в документе нужные данные и временно скрывает остальные.

Путь до файла Excel настраивается в контейнере Приложение Excel. При необходимости сохранить изменения в файле, используйте элемент Сохранить документ.

Свойства

Символ * указывает на обязательность заполнения. Описание общих свойств см. здесь.

Excel

1. Диапазон* [String] — диапазон ячеек для фильтрации. Пример: "B1:B12". Если диапазон не указан, будет отфильтрован выделенный диапазон.

2. Фильтр* [List<string>] — значения фильтра. Откройте редактор коллекций по иконке таблицы:

   

   Введите условие фильтрации в строку, обернув его кавычками, поскольку фильтр имеет тип данных String:

   

   Чтобы добавить еще один фильтр, нажмите Enter и введите новое значение в следующей строке. Если вы используете не более двух условий фильтрации, то можете применять в них следующие символы замещения:

   • Символ * — замещает любое количество символов. Например, если вам нужно отфильтровать значения, которые начинаются с "ИП", то укажите в фильтре: "ИП*".

   • Символ ?— замещает только один символ.

   Если условий более двух, необходимо использовать точное совпадение значений.

3. Страница [String] — название страницы, если документ имеет несколько листов. Пример: "Лист1".

4. Индекс страницы [Int32] — порядковый номер страницы, если документ имеет несколько листов. Нумерация ведется с нуля. Пример: 0.

Настраиваемый фильтр - Функция доступна с версии 1.25.1

1. 1-го значения тип фильтра - Указывает тип фильтра для первого значения. Используется перечисление [LTools.Office.Model.Excel.FilterTypes].

2. 1-е значение фильтра - Значение первого настраиваемого фильтра.

3. 2-го значения тип фильтра - Указывает тип фильтра для второго значения. Используется перечисление [LTools.Office.Model.Excel.FilterTypes].

4. 2-е значение фильтра - Значение второго настраиваемого фильтра.

5. Или/И - Логическое условие, задающее связь между первым и вторым фильтрами (И/ИЛИ).

Тип фильтра = корректно работает только со строковыми значениями.

Пример использования:

1. Настройте 1-го значения тип фильтра на = и задайте строковое значение в 1-е значение фильтра.

2. Настройте Или/И на "И", чтобы оба условия фильтрации были обязательными.

3. Установите 2-го значения тип фильтра на != и задайте значение в 2-е значение фильтра.

4. Примените фильтр.

После снятия фильтров таблица вернётся к исходному виду.

Только код

Пример использования элемента в процессе с типом Только код (Pure code):

C#

LTools.Office.ExcelApp app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX);
app.FilterRange(new List<string>(), "A1:C12", "Лист1");

Python

app = LTools.Office.ExcelApp.Init(wf, "file", ";", LTools.Office.Model.InteropTypes.DX)
app.FilterRange(List[String](), "A1:C12", "Лист1")

JavaScript

var host = new _lib.Microsoft.ClearScript.HostFunctions();
var lst = host.newObj(_lib.System.Collections.Generic.List(_lib.System.String));
var app = _lib.LTools.Office.ExcelApp.Init(wf, "file", ";", _lib.LTools.Office.Model.InteropTypes.DX);
app.FilterRange(lst, "A1:C12", "Лист1");