Поиск изображения

Элемент производит поиск заданного изображения на экране. Если искомое изображение не указано, для поиска используется растр из скриншота элемента.

Свойства

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

OCR

1. Искомое изображение [System.Drawing.Bitmap] — растр изображения, которое требуется найти на экране.
2. Точность [Double] — минимальная точность совпадения (от 0 до 1).. По умолчанию 0.9.
3. Таймаут* [Int32] — предельное время ожидания завершения процесса (мс). По умолчанию 10000.

Вывод

1. Координаты [System.Drawing.Rectangle] — название переменной, в которую сохранятся координаты найденного изображения.

2. Результат [Boolean] — название переменной, в которую сохранится результат поиска:

   • true — изображение найдено.
   • false — изображение не найдено.

3. Создавать исключение [Boolean] — определяет, следует ли создавать исключение, если изображение не нашлось. По умолчанию включено, исключение будет создаваться.

4. Вид сортировки
   [Enum] — определяет порядок обработки найденных изображений. Доступно с версии Studio 1.26.1 Возможные значения:

   • По точности совпадения — изображения сортируются от наиболее точного совпадения к наименее точному;
   • Координаты — сортировка по расположению изображений на экране (слева направо, сверху вниз)

5. Все изображения
   [Boolean] — определяет режим поиска. Доступно с версии Studio 1.26.1

   • false — возвращается только одно (наиболее подходящее) изображение;
   • true — возвращаются все найденные совпадения.

6. Границы изображений
   [List<System.Drawing.Rectangle>] — область экрана, в пределах которой выполняется поиск.
   Позволяет ускорить выполнение и снизить количество ложных совпадений. Доступно с версии Studio 1.26.1

7. Границы изображения
   [System.Drawing.Rectangle] — границы найденного изображения, определяемые значением свойства Индекс изображения. Доступно с версии Studio 1.26.1

8. Индекс изображения
   [Int32] — индекс изображения в списке найденных совпадений (используется при включённом параметре Все изображения).
   По умолчанию: 0. Доступно с версии Studio 1.26.1

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

RPA-проект, демонстрирующий работу элемента, можно найти в нашем публичном репозитории Learning .

1. Скачайте архив со всеми обучающими материалами по ссылке: Скачать архив Learning .
2. Распакуйте архив и откройте в Студии проект StudioActivities.
3. Откройте процесс Поиск изображения.ltw в соответствующей папке проекта.

Только код (Pure code)

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

LTools.OCR.OcrApp app = LTools.OCR.OcrApp.InitMicrosoft(wf,
"ru-RU"); System.Drawing.Rectangle coords = LTools.OCR.OcrApp.Exists(wf,
(System.Drawing.Bitmap)System.Drawing.Bitmap.FromFile("Файл 1"), 0.9,
10000);

app = LTools.OCR.OcrApp.InitMicrosoft(wf, "ru-RU") coords =
LTools.OCR.OcrApp.Exists(wf, System.Drawing.Bitmap.FromFile("Файл 1"), 0.9,
10000)

var app = _lib.LTools.OCR.OcrApp.InitMicrosoft(wf, "ru-RU");
var coords = _lib.LTools.OCR.OcrApp.Exists(wf,
_lib.System.Drawing.Bitmap.FromFile("Файл 1"), 0.9, 10000);

Дополнительные методы режима Pure Code (Только код)

• FindImages() — возвращает Rectangle[] со всеми найденными областями;
• FindImage(int index) — возвращает Rectangle по указанному индексу.

Метод Exists() помечен как устаревший для новых разработок, но полностью сохранён для обратной совместимости.