ListBox.FindItem

number ListBox.FindItem ( string ObjectName,
number StartAfter,
number SearchType,
string SearchText )
Примеры

Описание

Поиск среди элементов объекта список (listbox) указанной строки и возврат индекса (номера строки), где она была найдена.

Параметры

ObjectName

(строка) Имя объекта список (listbox).

StartAfter

(число) Индекс (номер строки), после которой начнется поиск. Поиск будет начат со следующего элемента в объекте список. В качестве индекса (указателя) можно использовать -1 (или переменную LB_ALLITEMS) для поиска по всем элементам объекта список (listbox).

SearchType

(число) Тип выполняемого поиска:

КОНСТАНТА
CONSTANT
ЗНАЧЕНИЕ
VALUE
ОПИСАНИЕ
DESCRIPTION
LB_BYTEXT0Поиск только текста элемента. (По умолчанию)
LB_BYDATA1Поиск только данных связанных с элементом.
LB_BYTEXTDATA2Поиск и текста элемента и связанных с ним данных.

SearchText

(строка) Строка текста для поиска в объекте список (listbox). Для поиска текста, что соответствуют указанному шаблону, в этом поле можно использовать подстановочные знаки * и ?.

Возврат

ResultVariable

(число) Индекс первого элемента найденной искомой строки. Если строка не была найдена или произошла ошибка, возвращается значение -1 (переменная LB_ERROR). Можно использовать действие Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.
Смотрите также: Связанные действия

Примеры

Пример 1

search_index = ListBox.FindItem("ListBox1", -1, 0, "Document");
Поиск среди всех элементов объекта список (listbox) "ListBox1" текста элемента, содержащего строковое значение "Document". Переменная "search_index" будет хранить индекс первого найденного элемента.

Пример 2

dog_index = ListBox.FindItem("PictureShow", 5, 1, "Dog");
Поиск данных элемента, содержащих строку "Dog", начинающийся с 6 индекса объекта список (listbox) "PictureShow". Если что-то будет найдено, индекс этого элемента будет сохранен в переменной dog_index.

Пример 3

search_index = ListBox.FindItem("ListBox1", -1, LB_BYDATA, "*.txt");
Поиск среди всех элементов объекта список (listbox) "ListBox1" данных элемента, содержащих любую строку пути, оканчивающуюся на .txt. Заметьте, что здесь используется подстановочный знак "*". Если что-то будет найдено, индекс этого элемента будет сохранен в переменной search_index.
Смотрите также: Связанные действия