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

Eng: Filter Range

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

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

Свойства

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

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

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

   

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

   

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

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

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

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

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

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

Только код

Пример использования элемента в процессе с типом Только код (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");