На этом шаге мы перечислим методы, используемые для поиска элементов.
Произвести поиск элемента в списке позволяют методы
- findText() (по тексту элемента) и
- findData() (по данным с указанной ролью).
Методы возвращают индекс найденного элемента или значение -1, если таковой не был найден.
Форматы методов:
findText(<Текст>[, flags=MatchExactly | MatchCaseSensitive]) findData(<Данные>[, role=UserRole][, flags=MatchExactly | MatchCaseSensitive])
Параметр flags задает режим поиска. В качестве значения через оператор | можно указать комбинацию следующих атрибутов класса QtCore.Qt:
- MatchExactly (или 0) - поиск полного соответствия;
- MatchContains (или 1) - поиск совпадения с любой частью;
- MatchStartsWith (или 2) - совпадение с началом;
- MatchEndsWith (или 3) - совпадение с концом;
- MatchRegExp (или 4) - поиск с помощью регулярного выражения;
- MatchWildcard (или 5) - используются подстановочные знаки;
- MatchFixedString (или 8) - поиск полного соответствия внутри строки, выполняемый по умолчанию без учета регистра символов;
- MatchCaseSensitive (или 16) - поиск с учетом регистра символов;
- MatchWrap (или 32) - если просмотрены все элементы, и подходящий элемент не найден, поиск начнется с начала списка;
- MatchRecursive (или 64) - просмотр всей иерархии.
На следующем шаге мы рассмотрим сигналы, поддерживаемые этим классом.
