39 KiB

Raw Blame History Unescape Escape

7. Функции Screen

Общее

Документация к модулю будет опубликована в Июле 2022. По всем вопросам роботизации WEB приложений обращайтесь в центр поддержки клиентов pyOpenRPA.

Дорогие коллеги!

Мы знаем, что с pyOpenRPA вы сможете существенно улучшить качество вашего бизнеса. Платформа роботизации pyOpenRPA - это разработка, которая дает возможность делать виртуальных сотрудников (программных роботов RPA) выгодными, начиная от эффекта всего в 10 тыс. руб. И управлять ими будете только Вы!

Если у вас останутся вопросы, то вы всегда можете обратиться в центр поддержки клиентов pyOpenRPA. Контакты: 2. Лицензия & Контакты

pyOpenRPA - роботы помогут!

Класс Box

Экземпляр класса pyscreeze.Box, который характеризует прямоугольную область на экране.

top - координата левой верхней точки в пикселях по оси X (горизонталь) left - координата левой верхней точки в пикселях по оси Y (вертикаль) height - расстояние вниз от левой верхней точки в пикселях width - расстояние вправо от левой верхней точки в пикселях

Класс Point

Экземпляр класса pyscreeze.Point, который характеризует точку на экране.

x - координата точки в пикселях по оси X (горизонталь) y - координата точки в пикселях по оси Y (вертикаль)

Символьное указание точки (inPointRuleStr)

LU|CU|RU

LC|CC|RC

LD|CD|RD

Символьное указание точки - точка относительно которой выполнить изменение прямоугольной области.

«CC»,

Формат образования кода: XY, где

X обозначает положение по горизонтали (допустимые значения: «L», «C», «R»)
Y обозначает положение по вертикали (допустимые значения: «U», «C», «D»)

Допустимые значения:

«CC» - центр по горизонтали, центр по вертикали
«LU» - левый край по горизонтали, верхний край по вертикали
«LD» - левый край по горизонтали, нижний край по вертикали
«RD» - правый край по горизонтали, нижний край по вертикали
«RU» - правый край по горизонтали, верхний край по вертикали

X-10 - корректировка координаты по оси X на 10 пикселей влево Y+20 - корректировка координаты по оси Y на 20 пикселей вниз

Символьное указание области (inAnchorRuleStr)

LU|CU|RU

LC|CC|RC

LD|CD|RD

Символьное указание области поиска - область относительно которой выполнить поиск другой прямоугольной области.

«CC»,

Формат образования кода: XY, где

X обозначает область по горизонтали (допустимые значения: «L», «C», «R»)
Y обозначает область по вертикали (допустимые значения: «U», «C», «D»)

Допустимые значения:

«CC» - выбранная прямоугольная область
«LU» - слева и сверху от выбранной прямоугольной области
«LD» - слева и снизу от выбранной прямоугольной области
«LС» - слева от выбранной прямоугольной области
«RC» - справа от выбранной прямоугольной области
«СU» - сверху от выбранной прямоугольной области
«CD» - сверху от выбранной прямоугольной области
«RD» - справа и снизу от выбранной прямоугольной области
«RU» - справа и сверху от выбранной прямоугольной области

Опция «S» (strict) - искомый объект должен всеми своими координатами находиться в обозначенной прямоугольной области

Формат допускает комбинации нескольких областей в одной строке. Пример: «CC,LU,LD,S» «CC|LU|LD|S» «CCLULDS»

Графическая интерпретация: +|-

|-
-----
-|+|

—– +|-

Описание функций

Functions:

| BoxAnchorRuleCheck(inBox[, inAnchorBox, …])

| Выполнить проверку соответствия всем условиям вхождения inBox в inAnchorBox с учетом правил inAnchorRule

| | BoxCreate(inTopInt, inLeftInt, inHeightInt, …)

| Создать экземпляр прямоугольной области.

                                                                                                                                                            |

| BoxDraw(inBox[, inColorStr, inThicknessInt])

  | Выполнить подсветку прямоугольной области inBox на экране

                                                                                                                                           |

| BoxGetPoint(inBox[, inPointRuleStr])

          | Получить точку pyscreeze.Point по заданной прямоугольной области pyscreeze.Box и строковому параметру расположения inPointRuleStr.

                                                                  |

| BoxModify(inBox[, inDWidthInt, …])

            | Изменить ширину / высоту прямоугольной области.

                                                                                                                                                     |

| BoxMoveTo(inBox[, inDXInt, inDYInt])

          | Переместить прямоугольную область (сохранить длину/ширину).

                                                                                                                                         |

| BoxOverlay(inBox1, inBox2)

                    | Проверить наложение 2-х прямоугольных областей друг на друга.

                                                                                                                                       |

| ImageClick(inImgPathStr[, inBoxIndexInt, …])

  | Выполнить поиск прямоугольной области по изображению.

                                                                                                                                               |

| ImageExists(inImgPathStr[, …])

                | Проверить, имеется ли на экране хотя бы один подходящий объект.

                                                                                                                                     |

| ImageLocateAll(inImgPathStr[, …])

             | Искать на экране графические объекты, которые похожи на inImgPathStr.

                                                                                                                               |

| ImageWaitAppear(inImgPathStr[, …])

            | Ожидать появление изображения на протяжении inWaitSecFloat секунд.

                                                                                                                                  |

| ImageWaitDisappear(inImgPathStr[, …])

         | Ожидать исчезновение изображения на протяжении inWaitSecFloat секунд.

                                                                                                                               |

| PointClick(inPoint[, inClickCountInt, …])

     | Нажатие (вниз) кнопки мыши и затем немедленно выпуск (вверх) её.

                                                                                                                                    |

| PointClickDouble(inPoint[, inWaitAfterSecFloat])

| Двойное нажатие левой клавиши мыши.

| PointCreate(inXInt, inYInt)

                   | Создать точку pyscreeze.Point.

                                                                                                                                                                      |

| PointDown(inPoint[, inButtonStr, …])

          | Переместить указатель по координатам inPoint, после чего нажать (вниз) клавишу мыши и не отпускать до выполнения соответсвующей команды (см.

                                                        |

| PointModify(inPoint, inDXInt, inDYInt)

        | Скорректировать точку pyscreeze.Point.

                                                                                                                                                              |

| PointMoveTo(inPoint[, inWaitAfterSecFloat])

   | Переместить указатель мыши на позицию inXInt, inYInt за время inMoveDurationSecFloat.

                                                                                                               |

| PointUp(inPoint[, inButtonStr, …])

            | Отпустить (вверх) клавишу мыши.

                                                                                                                                                                     |

pyOpenRPA.Robot.Screen.BoxAnchorRuleCheck(inBox, inAnchorBox=None, inAnchorRuleStr=None)

Выполнить проверку соответствия всем условиям вхождения inBox в inAnchorBox с учетом правил inAnchorRule

# Screen: Взаимодействие с экраном
from pyOpenRPA.Robot import Screen
lBox1 = Screen.BoxCreate(inTopInt=265, inLeftInt=62, inHeightInt=100, inWidthInt=90)
lBox2 = Screen.BoxCreate(inTopInt=160, inLeftInt=160, inHeightInt=100, inWidthInt=100)
lBox3 = Screen.BoxCreate(inTopInt=460, inLeftInt=60, inHeightInt=100, inWidthInt=100)

l = Screen.BoxAnchorRuleCheck(inBox=lBox1, inAnchorBox=[lBox2,lBox3], inAnchorRuleStr=["LD","CUS"])
Screen.BoxDraw([lBox1,lBox2,lBox3])

Параметры
- inBox (pyscreeze.Box) – Экземпляр класса прямоугольной области Box
- inAnchorBox (pyscreeze.Box или list из pyscreeze.Box) – Экземпляр класса прямоугольной области Box
- inAnchorRuleStr (str или list из str) – Символьное указание области проверки соответствия. Может принимать единственное значение (единый формат для всех inAnchorBox), или список форматов для каждого inAnchorBox (если inAnchorBox является списком Box)
Результат

True - соответствует всем правилам
Тип результата

bool

pyOpenRPA.Robot.Screen.BoxCreate(inTopInt: int, inLeftInt: int, inHeightInt: int, inWidthInt: int)

Создать экземпляр прямоугольной области.

!ВНИМАНИЕ! Координаты inTopInt, inLeftInt определяют верхний левый край прямоугольной области.

Параметры
- inTopInt (int) – Координата левой верхней точки в пикселях по оси X (горизонталь)
- inLeftInt (int) – Координата левой верхней точки в пикселях по оси Y (вертикаль)
- inHeightInt (int) – Расстояние вниз от левой верхней точки в пикселях
- inWidthInt (int) – Расстояние вправо от левой верхней точки в пикселях

pyOpenRPA.Robot.Screen.BoxDraw(inBox, inColorStr='green', inThicknessInt=2)

Выполнить подсветку прямоугольной области inBox на экране

!ВНИМАНИЕ! РАБОТАЕТ ТОЛЬКО НА ОС WINDOWS

!ВНИМАНИЕ! ПОДДЕРЖИВАЕТ ПАКЕТНУЮ ОБРАТКУ ПРИ ПЕРЕДАЧЕ СПИСКА ЭКЗЕМПЛЯРОВ BOX

# Screen: Взаимодействие с экраном
from pyOpenRPA.Robot import Screen
# ВАРИАНТ ОТРИСОВКИ 1ГО ЭЛЕМЕНТА
# Создать пробную прямоугольную область
lBox = Screen.BoxCreate(inTopInt=10, inLeftInt=10, inHeightInt=10, inWidthInt=10)
Screen.BoxDraw(lBox)

# ВАРИАНТ ПАКЕТНОЙ ОТРИСОВКИ
# Создать пробную прямоугольную область
lBox = Screen.BoxCreate(inTopInt=10, inLeftInt=10, inHeightInt=100, inWidthInt=100)
lBox2 = Screen.BoxCreate(inTopInt=60, inLeftInt=60, inHeightInt=100, inWidthInt=100)
Screen.BoxDraw([lBox, lBox2])

Параметры
- inBox (pyscreeze.Box) – Экземпляр класса прямоугольной области Box
- inColorStr (str*, *необязательный) – цвет подсветки прямоугольной области. Варианты: „red“, „green“, „blue“. По умолчанию „green“
- inThicknessInt (int*, *необязательный) – толщина подсветки прямоугольной области. По умолчанию 2

pyOpenRPA.Robot.Screen.BoxGetPoint(inBox, inPointRuleStr='CC')

Получить точку pyscreeze.Point по заданной прямоугольной области pyscreeze.Box и строковому параметру расположения inPointRuleStr.

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lBox1 = Screen.BoxCreate(inTopInt=10, inLeftInt=10, inHeightInt=100, inWidthInt=1000)
lPoint = Screen.BoxGetPoint(inBox=lBox1, inPointRuleStr="LC")

Параметры
- inBox (pyscreeze.Box*, *обязательный) – Прямоугольная область на экране
- inPointRuleStr (str*, *опциональный) – Правило идентификации точки на прямоугольной области (правила формирования см. выше). Варианты: «LU»,»CU»,»RU»,»LC»,»CC»,»RC»,»LD»,»CD»,»RD». По умолчанию «CC»
Результат

Точка на экране
Тип результата

pyscreeze.Point

pyOpenRPA.Robot.Screen.BoxModify(inBox, inDWidthInt=None, inDHeightInt=None, inPointRuleStr='CC')

Изменить ширину / высоту прямоугольной области.

!ВНИМАНИЕ! ПОДДЕРЖИВАЕТ ПАКЕТНУЮ ОБРАТКУ ПРИ ПЕРЕДАЧЕ СПИСКА ЭКЗЕМПЛЯРОВ BOX

!ВНИМАНИЕ! ЕСЛИ СМЕЩЕНИЕ ПРИВЕДЕТ К ОБРАЗОВАНИЮ ДРОБНОГО ЧИСЛА, БУДЕТ ВЫПОЛНЕНО ОКРУГЛЕНИЕ ПО МАТЕМАТИЧЕСКИМ ПРАВИЛАМ

# Screen: Взаимодействие с экраном
from pyOpenRPA.Robot import Screen
# Вариант изменения 1-го элемента
# Создать пробную прямоугольную область
lBox = Screen.BoxCreate(inTopInt=10, inLeftInt=10, inHeightInt=10, inWidthInt=10)
# Скорректировать пробную прямоугольную область
lBox2 = Screen.BoxModify(lBox,10,10,"CC"); print(lBox2)
lBox2 = Screen.BoxModify(lBox,10,10,"LU"); print(lBox2)
lBox2 = Screen.BoxModify(lBox,10,10,"LD"); print(lBox2)
lBox2 = Screen.BoxModify(lBox,10,10,"RU"); print(lBox2)
lBox2 = Screen.BoxModify(lBox,10,10,"RD"); print(lBox2)

Параметры
- inBox (pyscreeze.Box) – Экземпляр класса прямоугольной области Box
- inDXInt (int*, *опциональный) – Смещение левой верхней координаты по оси X в пикселях (горизонтальная ось).
- inDYInt (int*, *опциональный) – Смещение левой верхней координаты по оси Y в пикселях (вертикальная ось).
- inPointRuleStr (str*, *опциональный) – Символьное указание точки (подробнее см. выше), относительно которой выполнить изменение прямоугольной области. Допустимые значения: «CC» (по умолчанию), «LU», «LD», «RD», «RU»
Результат

Экземпляр класса прямоугольной области Box
Тип результата

pyscreeze.Box

pyOpenRPA.Robot.Screen.BoxMoveTo(inBox, inDXInt=None, inDYInt=None)

Переместить прямоугольную область (сохранить длину/ширину).

!ВНИМАНИЕ! ПОДДЕРЖИВАЕТ ПАКЕТНУЮ ОБРАТКУ ПРИ ПЕРЕДАЧЕ СПИСКА ЭКЗЕМПЛЯРОВ BOX

# Screen: Взаимодействие с экраном
from pyOpenRPA.Robot import Screen
# Вариант изменения 1-го элемента
# Создать пробную прямоугольную область
lBox = Screen.BoxCreate(inTopInt=10, inLeftInt=10, inHeightInt=10, inWidthInt=10)
# Переместить пробную прямоугольную область
lBox = Screen.BoxMoveTo(lBox, inDXInt=100, inDYInt=200)

Параметры
- inBox (pyscreeze.Box) – Экземпляр класса прямоугольной области Box
- inDXInt (int*, *опциональный) – Смещение левой верхней координаты по оси X в пикселях (горизонтальная ось).
- inDYInt (int*, *опциональный) – Смещение левой верхней координаты по оси Y в пикселях (вертикальная ось).
Результат

Экземпляр класса прямоугольной области Box
Тип результата

pyscreeze.Box

pyOpenRPA.Robot.Screen.BoxOverlay(inBox1, inBox2)

Проверить наложение 2-х прямоугольных областей друг на друга.

# Screen: Взаимодействие с экраном
from pyOpenRPA.Robot import Screen
lBox1 = Screen.BoxCreate(inTopInt=10, inLeftInt=10, inHeightInt=100, inWidthInt=1000)
lBox2 = Screen.BoxCreate(inTopInt=160, inLeftInt=160, inHeightInt=100, inWidthInt=100)
Screen.BoxDraw([lBox1, lBox2])
Screen.BoxOverlay(lBox1,lBox2)

Параметры
- inBox1 (pyscreeze.Box) – Экземпляр класса прямоугольной области Box
- inBox2 (pyscreeze.Box) – Экземпляр класса прямоугольной области Box
Результат

True - inBox1 наложен на inBox2
Тип результата

bool

pyOpenRPA.Robot.Screen.ImageClick(inImgPathStr: str, inBoxIndexInt: int = 0, inPointRuleStr: str = 'CC', inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0, inWaitSecFloat: float = 0, inWaitIntervalSecFloat: float = 0)

Выполнить поиск прямоугольной области по изображению.

# Screen: Взаимодействие с объектами экрана
from pyOpenRPA.Robot import Screen
Screen.ImageClick(inImgPathStr="Button.png",inConfidenceFloat=0.9)

Параметры
- inImgPathStr (str*, *относительный или абсолютный) – Путь к изображению, которое требуется искать на экране
- inBoxIndexInt (int*, *опционально) – Индекс прямоугольной области, по которой выполнить клик (если обнаружено несколько областей Box), По умолчанию 0
- inPointRuleStr (str*, *опциональный) – Правило идентификации точки на прямоугольной области (правила формирования см. выше). Варианты: «LU»,»CU»,»RU»,»LC»,»CC»,»RC»,»LD»,»CD»,»RD». По умолчанию «CC»
- inIsGrayModeBool (bool*, *опционально) – True - выполнить поиск изображения в режиме серых оттенков (ускоряет производительность, если допускается искажение цвета). По умолчанию False
- inConfidenceFloat (float*, *опционально) – Показатель точности. 1.0 - идентичное соответствие, 0.0 - полное несоответствие. По умолчанию 1.0
- inWaitSecFloat (float*, *опциональный) – Время ожидания появления изображения в сек. По умолчанию 0
- inWaitIntervalSecFloat (float*, *опциональный) – Интервал повторной проверки наличия изображения. По умолчанию 0

pyOpenRPA.Robot.Screen.ImageExists(inImgPathStr: str, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

Проверить, имеется ли на экране хотя бы один подходящий объект. Вернуть булево значение

# Screen: Взаимодействие с объектами экрана
from pyOpenRPA.Robot import Screen
lResult = Screen.ImageExists(inImgPathStr="Button.png",inConfidenceFloat=0.9)

Параметры
- inImgPathStr (str*, *относительный или абсолютный) – Путь к изображению, которое требуется искать на экране
- inIsGrayModeBool (bool*, *опционально) – True - выполнить поиск изображения в режиме серых оттенков (ускоряет производительность, если допускается искажение цвета). По умолчанию False
- inConfidenceFloat (float*, *опционально) – Показатель точности. 1.0 - идентичное соответствие, 0.0 - полное несоответствие. По умолчанию 1.0
Результат

Список из pyscreeze.Box
Тип результата

list

pyOpenRPA.Robot.Screen.ImageLocateAll(inImgPathStr: str, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

Искать на экране графические объекты, которые похожи на inImgPathStr. Вернуть список прямоугольных областей на экране (pyscreeze.Box)

# Screen: Взаимодействие с объектами экрана
from pyOpenRPA.Robot import Screen
Screen.ImageLocateAll(inImgPathStr="Button.png",inConfidenceFloat=0.9)

Параметры
- inImgPathStr (str*, *относительный или абсолютный) – Путь к изображению, которое требуется искать на экране
- inIsGrayModeBool (bool*, *опционально) – True - выполнить поиск изображения в режиме серых оттенков (ускоряет производительность, если допускается искажение цвета). По умолчанию False
- inConfidenceFloat (float*, *опционально) – Показатель точности. 1.0 - идентичное соответствие, 0.0 - полное несоответствие. По умолчанию 1.0
Результат

Список из pyscreeze.Box
Тип результата

list

pyOpenRPA.Robot.Screen.ImageWaitAppear(inImgPathStr: str, inWaitSecFloat: float = 60, inWaitIntervalSecFloat: float = 1.0, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

Ожидать появление изображения на протяжении inWaitSecFloat секунд. Проверять с периодичностью inWaitIntervalSecFloat. Вернуть список прямоугольных областей, которые удовлетворяют условию

# Screen: Взаимодействие с объектами экрана
from pyOpenRPA.Robot import Screen
lBoxList = Screen.ImageWaitAppear(inImgPathStr="Button.png",inConfidenceFloat=0.9)

Параметры
- inImgPathStr (str*, *относительный или абсолютный) – Путь к изображению, которое требуется искать на экране
- inWaitSecFloat (float*, *опциональный) – Время ожидания появления изображения в сек. По умолчанию IMAGE_WAIT_SEC_FLOAT (60)
- inWaitIntervalSecFloat (float*, *опциональный) – Интервал повторной проверки наличия изображения. По умолчанию IMAGE_WAIT_INTERVAL_SEC_FLOAT (1)
- inIsGrayModeBool (bool*, *опционально) – True - выполнить поиск изображения в режиме серых оттенков (ускоряет производительность, если допускается искажение цвета). По умолчанию False
- inConfidenceFloat (float*, *опционально) – Показатель точности. 1.0 - идентичное соответствие, 0.0 - полное несоответствие. По умолчанию 1.0
Результат

Список из pyscreeze.Box или [] если прошло время ожидания.
Тип результата

list

pyOpenRPA.Robot.Screen.ImageWaitDisappear(inImgPathStr: str, inWaitSecFloat: float = 60, inWaitIntervalSecFloat: float = 1.0, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

Ожидать исчезновение изображения на протяжении inWaitSecFloat секунд. Проверять с периодичностью inWaitIntervalSecFloat.

# Screen: Взаимодействие с объектами экрана
from pyOpenRPA.Robot import Screen
Screen.ImageWaitDisappear(inImgPathStr="Button.png",inConfidenceFloat=0.9)

Параметры
- inImgPathStr (str*, *относительный или абсолютный) – Путь к изображению, которое требуется искать на экране
- inWaitSecFloat (float*, *опциональный) – Время ожидания появления изображения в сек. По умолчанию IMAGE_WAIT_SEC_FLOAT (60)
- inWaitIntervalSecFloat (float*, *опциональный) – Интервал повторной проверки наличия изображения. По умолчанию IMAGE_WAIT_INTERVAL_SEC_FLOAT (1)
- inIsGrayModeBool (bool*, *опционально) – True - выполнить поиск изображения в режиме серых оттенков (ускоряет производительность, если допускается искажение цвета). По умолчанию False
- inConfidenceFloat (float*, *опционально) – Показатель точности. 1.0 - идентичное соответствие, 0.0 - полное несоответствие. По умолчанию 1.0

pyOpenRPA.Robot.Screen.PointClick(inPoint: pyscreeze.Point, inClickCountInt: int = 1, inIntervalSecFloat: float = 0.0, inButtonStr: str = 'left', inMoveDurationSecFloat: float = 0.0, inWaitAfterSecFloat: Optional[float] = None)

Нажатие (вниз) кнопки мыши и затем немедленно выпуск (вверх) её. Допускается следующая параметризация.

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(100,150)
Screen.PointClick(lPoint) #Выполнить нажатие левой клавиши мыши

Параметры
- inPoint (pyscreeze.Point*, *обязательный) – Точка на экране, по которой выполнить нажатие мыши
- inClickCountInt (int*, *опциональный) – Количество нажатий (вниз и вверх) кнопкой мыши, По умолчанию 1
- inIntervalSecFloat (float*, *опциональный) – Интервал ожидания в секундах между нажатиями, По умолчанию 0.0
- inButtonStr (str*, *опциональный) – Номер кнопки, которую требуется нажать. Возможные варианты: „left“, „middle“, „right“ или 1, 2, 3. В остальных случаях инициирует исключение ValueError. По умолчанию „left“
- inMoveDurationSecFloat (float*, *опциональный) – Время перемещения указателя мыши, По умолчанию 0.0 (моментальное перемещение)
- inWaitAfterSecFloat (float*, *опциональный) – Количество секунд, которые ожидать после выполнения операции. По умолчанию установлено в настройках модуля Mouse (базовое значение 0.4)

pyOpenRPA.Robot.Screen.PointClickDouble(inPoint: pyscreeze.Point, inWaitAfterSecFloat: Optional[float] = None)

Двойное нажатие левой клавиши мыши. Данное действие аналогично вызову функции (см. ниже).

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(100,150)
Screen.PointClickDouble(lPoint) #Выполнить двойное нажатие левой клавиши мыши

Параметры
- inPoint (pyscreeze.Point*, *обязательный) – Точка на экране, по которой выполнить нажатие мыши
- inWaitAfterSecFloat (float*, *опциональный) – Количество секунд, которые ожидать после выполнения операции. По умолчанию установлено в настройках модуля Mouse (базовое значение 0.4)

pyOpenRPA.Robot.Screen.PointCreate(inXInt, inYInt)

Создать точку pyscreeze.Point.

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(inXInt=10, inYInt=10)

Параметры
- inXInt (int*, *опциональный) – Смещение указателя мыши по оси X (горизонтальная ось).
- inYInt (int*, *опциональный) – Смещение указателя мыши по оси Y (вертикальная ось).
Результат

Точка на экране
Тип результата

pyscreeze.Point

pyOpenRPA.Robot.Screen.PointDown(inPoint: pyscreeze.Point, inButtonStr: str = 'left', inWaitAfterSecFloat: Optional[float] = None)

Переместить указатель по координатам inPoint, после чего нажать (вниз) клавишу мыши и не отпускать до выполнения соответсвующей команды (см. Up).

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(100,150)
Screen.PointDown(lPoint)

Параметры
- inPoint (pyscreeze.Point*, *обязательный) – Точка на экране, по которой выполнить нажатие мыши
- inButtonStr (str*, *опциональный) – Номер кнопки, которую требуется нажать. Возможные варианты: „left“, „middle“, „right“ или 1, 2, 3. В остальных случаях инициирует исключение ValueError. По умолчанию „left“
- inWaitAfterSecFloat (float*, *опциональный) – Количество секунд, которые ожидать после выполнения операции. По умолчанию установлено в настройках модуля Mouse (базовое значение 0.4)

pyOpenRPA.Robot.Screen.PointModify(inPoint, inDXInt, inDYInt)

Скорректировать точку pyscreeze.Point.

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(inXInt=10, inYInt=10)
lPoint = Screen.PointModify(inPoint=lPoint, inDXInt=90, inDYInt=10)

Параметры
- inPoint (pyscreeze.Point*, *обязательный) – Точка на экране, по которой выполнить нажатие мыши
- inDXInt (int*, *опциональный) – Смещение указателя мыши по оси X (горизонтальная ось).
- inDYInt (int*, *опциональный) – Смещение указателя мыши по оси Y (вертикальная ось).
Результат

Точка на экране
Тип результата

pyscreeze.Point

pyOpenRPA.Robot.Screen.PointMoveTo(inPoint: pyscreeze.Point, inWaitAfterSecFloat: Optional[float] = None)

Переместить указатель мыши на позицию inXInt, inYInt за время inMoveDurationSecFloat.

!ВНИМАНИЕ! Отсчет координат inXInt, inYInt начинается с левого верхнего края рабочей области (экрана).

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(100,150)
Screen.PointMoveTo(inXInt=100, inYInt=200)

Параметры
- inPoint (pyscreeze.Point*, *обязательный) – Точка на экране, по которой выполнить нажатие мыши
- inWaitAfterSecFloat (float*, *опциональный) – Количество секунд, которые ожидать после выполнения операции. По умолчанию установлено в настройках модуля Mouse (базовое значение 0.4)

pyOpenRPA.Robot.Screen.PointUp(inPoint: pyscreeze.Point, inButtonStr: str = 'left', inWaitAfterSecFloat: Optional[float] = None)

Отпустить (вверх) клавишу мыши.

# Screen: Взаимодействие с мышью объектами экрана
from pyOpenRPA.Robot import Screen
lPoint = Screen.PointCreate(100,150)
Screen.PointUp(lPoint)

Параметры
- inPoint (pyscreeze.Point*, *обязательный) – Точка на экране, по которой выполнить нажатие мыши
- inButtonStr (str*, *опциональный) – Номер кнопки, которую требуется поднять. Возможные варианты: „left“, „middle“, „right“ или 1, 2, 3. В остальных случаях инициирует исключение ValueError. По умолчанию „left“
- inWaitAfterSecFloat (float*, *опциональный) – Количество секунд, которые ожидать после выполнения операции. По умолчанию установлено в настройках модуля Mouse (базовое значение 0.4)

Быстрая навигация

Сообщество pyOpenRPA (telegram)
Сообщество pyOpenRPA (tenchat)
Сообщество pyOpenRPA (вконтакте)
Презентация pyOpenRPA
Портал pyOpenRPA
Репозиторий pyOpenRPA
```
  .. v1.2.13 replace:: v1.2.13
```

39 KiB Raw Blame History Unescape Escape

7. Функции Screen

Общее

Класс Box

Класс Point

Символьное указание точки (inPointRuleStr)

LU|CU|RU

LC|CC|RC

Символьное указание области (inAnchorRuleStr)

LU|CU|RU

LC|CC|RC

Описание функций

pyOpenRPA.Robot.Screen.BoxAnchorRuleCheck(inBox, inAnchorBox=None, inAnchorRuleStr=None)

pyOpenRPA.Robot.Screen.BoxCreate(inTopInt: int, inLeftInt: int, inHeightInt: int, inWidthInt: int)

pyOpenRPA.Robot.Screen.BoxDraw(inBox, inColorStr='green', inThicknessInt=2)

pyOpenRPA.Robot.Screen.BoxGetPoint(inBox, inPointRuleStr='CC')

pyOpenRPA.Robot.Screen.BoxModify(inBox, inDWidthInt=None, inDHeightInt=None, inPointRuleStr='CC')

pyOpenRPA.Robot.Screen.BoxMoveTo(inBox, inDXInt=None, inDYInt=None)

pyOpenRPA.Robot.Screen.BoxOverlay(inBox1, inBox2)

pyOpenRPA.Robot.Screen.ImageClick(inImgPathStr: str, inBoxIndexInt: int = 0, inPointRuleStr: str = 'CC', inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0, inWaitSecFloat: float = 0, inWaitIntervalSecFloat: float = 0)

pyOpenRPA.Robot.Screen.ImageExists(inImgPathStr: str, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

pyOpenRPA.Robot.Screen.ImageLocateAll(inImgPathStr: str, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

pyOpenRPA.Robot.Screen.ImageWaitAppear(inImgPathStr: str, inWaitSecFloat: float = 60, inWaitIntervalSecFloat: float = 1.0, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

pyOpenRPA.Robot.Screen.ImageWaitDisappear(inImgPathStr: str, inWaitSecFloat: float = 60, inWaitIntervalSecFloat: float = 1.0, inIsGrayModeBool: bool = False, inConfidenceFloat: float = 1.0)

pyOpenRPA.Robot.Screen.PointClick(inPoint: pyscreeze.Point, inClickCountInt: int = 1, inIntervalSecFloat: float = 0.0, inButtonStr: str = 'left', inMoveDurationSecFloat: float = 0.0, inWaitAfterSecFloat: Optional[float] = None)

pyOpenRPA.Robot.Screen.PointClickDouble(inPoint: pyscreeze.Point, inWaitAfterSecFloat: Optional[float] = None)

pyOpenRPA.Robot.Screen.PointCreate(inXInt, inYInt)

pyOpenRPA.Robot.Screen.PointDown(inPoint: pyscreeze.Point, inButtonStr: str = 'left', inWaitAfterSecFloat: Optional[float] = None)

pyOpenRPA.Robot.Screen.PointModify(inPoint, inDXInt, inDYInt)

pyOpenRPA.Robot.Screen.PointMoveTo(inPoint: pyscreeze.Point, inWaitAfterSecFloat: Optional[float] = None)

pyOpenRPA.Robot.Screen.PointUp(inPoint: pyscreeze.Point, inButtonStr: str = 'left', inWaitAfterSecFloat: Optional[float] = None)

Быстрая навигация

39 KiB

Raw Blame History Unescape Escape