from pyautogui import *
import time
WAIT_AFTER_SEC_FLOAT = 0.4 # Настройка модуля Mouse: Время, которое ожидать после выполнения любой операции модуля Mouse. Настройка является единой для всех участов кода, использующих модуль Mouse. Если для некоторой функции требуется изменить данное время ожидания, то в отношении этой функции можно применить соответсвующий аргумент.
def Click ( inXInt : int = None , inYInt : int = None , inClickCountInt : int = 1 , inIntervalSecFloat : float = 0.0 , inButtonStr : str = ' left ' , inMoveDurationSecFloat : float = 0.0 , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" Нажатие (вниз) кнопки мыши и затем немедленно выпуск (вверх) её. Допускается следующая параметризация. Если не указаны inXInt и inYInt - клик производится по месту нахождения указателя мыши.
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области ( экрана ) .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . Click ( 100 , 150 ) #Выполнить нажатие левой клавиши мыши на экране по координатам: X(г о р ) 100px, Y(вер) 150px.
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inClickCountInt : Количество нажатий ( вниз и вверх ) кнопкой мыши , По умолчанию 1
: type inClickCountInt : int , опциональный
: param inIntervalSecFloat : Интервал ожидания в секундах между нажатиями , По умолчанию 0.0
: type inIntervalSecFloat : float , опциональный
: param inButtonStr : Номер кнопки , которую требуется нажать . Возможные варианты : ' left ' , ' middle ' , ' right ' или 1 , 2 , 3. В остальных случаях инициирует исключение ValueError . По умолчанию ' left '
: type inButtonStr : str , опциональный
: param inMoveDurationSecFloat : Время перемещения указателя мыши , По умолчанию 0.0 ( моментальное перемещение )
: type inMoveDurationSecFloat : float , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
click ( x = inXInt , y = inYInt , clicks = inClickCountInt , interval = inIntervalSecFloat , button = inButtonStr , duration = inMoveDurationSecFloat )
time . sleep ( inWaitAfterSecFloat )
def ClickDouble ( inXInt : int = None , inYInt : int = None , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" Двойное нажатие левой клавиши мыши. Данное действие аналогично вызову функции (см. ниже).
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области ( экрана ) .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . ClickDouble ( 100 , 150 ) #Выполнить двойное нажатие левой клавиши мыши на экране по координатам: X(г о р ) 100px, Y(вер) 150px.
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inButtonStr : Номер кнопки , которую требуется нажать . Возможные варианты : ' left ' , ' middle ' , ' right ' или 1 , 2 , 3. В остальных случаях инициирует исключение ValueError . По умолчанию ' left '
: type inButtonStr : str , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
doubleClick ( x = inXInt , y = inYInt )
time . sleep ( inWaitAfterSecFloat )
def Down ( inXInt : int = None , inYInt : int = None , inButtonStr : str = ' left ' , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" Переместить указатель по координатам inXInt, inYInt, после чего нажать (вниз) клавишу мыши и не отпускать до выполнения соответсвующей команды (см. Up). Если координаты inXInt, inYInt не переданы - нажатие происходит на тех координатах X/Y, на которых указатель мыши находится.
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области ( экрана ) .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . Down ( ) #Опустить левую клавишу мыши
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inButtonStr : Номер кнопки , которую требуется нажать . Возможные варианты : ' left ' , ' middle ' , ' right ' или 1 , 2 , 3. В остальных случаях инициирует исключение ValueError . По умолчанию ' left '
: type inButtonStr : str , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
mouseDown ( x = inXInt , y = inYInt , button = inButtonStr )
time . sleep ( inWaitAfterSecFloat )
def Up ( inXInt : int = None , inYInt : int = None , inButtonStr : str = ' left ' , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" Отпустить (вверх) клавишу мыши. Если координаты inXInt, inYInt не переданы - нажатие происходит на тех координатах X/Y, на которых указатель мыши находится.
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . Up ( inButtonStr : str = ' right ' ) #Поднять правую клавишу мыши
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inButtonStr : Номер кнопки , которую требуется поднять . Возможные варианты : ' left ' , ' middle ' , ' right ' или 1 , 2 , 3. В остальных случаях инициирует исключение ValueError . По умолчанию ' left '
: type inButtonStr : str , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
mouseUp ( x = inXInt , y = inYInt , button = inButtonStr )
time . sleep ( inWaitAfterSecFloat )
def MoveTo ( inXInt = None , inYInt = None , inMoveDurationSecFloat : float = 0.0 , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" Переместить указатель мыши на позицию inXInt, inYInt за время inMoveDurationSecFloat.
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области ( экрана ) .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . MoveTo ( inXInt = 100 , inYInt = 200 ) #Переместить указатель мыши по координатам: X(г о р ) 100, Y(вер) 200
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inMoveDurationSecFloat : Время перемещения указателя мыши , По умолчанию 0.0 ( моментальное перемещение )
: type inMoveDurationSecFloat : float , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
moveTo ( x = inXInt , y = inYInt , duration = inMoveDurationSecFloat )
time . sleep ( inWaitAfterSecFloat )
def ScrollVertical ( inScrollClickCountInt , inXInt = None , inYInt = None , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" Переместить указатель мыши на позицию inXInt, inYInt и выполнить вертикальную прокрутку (скроллинг) колесом мыши на количество щелчков inScrollClickCountInt.
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области ( экрана ) .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . ScrollVertical ( 100 , inXInt = 100 , inYInt = 200 ) #Крутить колесо мыши вниз на 100 кликов по координатам: X(г о р ) 100, Y(вер) 200
Mouse . ScrollVertical ( - 100 ) #Крутить колесо мыши вверх на 100 кликов по текущим координатам указателя мыши.
: param inScrollClickCountInt : Количество щелчок колеса мыши , которое требуется ! вертикально ! прокрутить . Аргумент может принимать как положительное ( прокрутка вниз ) , так и отрицательное ( прокрутка вверх ) значения
: type inScrollClickCountInt : int , обязательный
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
vscroll ( inScrollClickCountInt , x = inXInt , y = inYInt )
time . sleep ( inWaitAfterSecFloat )
def ScrollHorizontal ( inScrollClickCountInt , inXInt = None , inYInt = None , inWaitAfterSecFloat : float = WAIT_AFTER_SEC_FLOAT ) :
""" !ТОЛЬКО ДЛЯ LINUX! Переместить указатель мыши на позицию inXInt, inYInt и выполнить горизонтальную прокрутку (скроллинг) виртуальным колесом мыши на количество щелчков inScrollClickCountInt.
! ВНИМАНИЕ ! Отсчет координат inXInt , inYInt начинается с левого верхнего края рабочей области ( экрана ) .
. . code - block : : python
# Mouse: Взаимодействие с мышью
from pyOpenRPA . Robot import Mouse
Mouse . ScrollHorizontal ( 100 , inXInt = 100 , inYInt = 200 ) #Крутить колесо мыши вниз на 100 кликов по координатам: X(г о р ) 100, Y(вер) 200
Mouse . ScrollHorizontal ( - 100 ) #Крутить колесо мыши вверх на 100 кликов по текущим координатам указателя мыши.
: param inScrollClickCountInt : Количество щелчок колеса мыши , которое требуется ! горизонтально ! прокрутить . Аргумент может принимать как положительное ( прокрутка вправо ) , так и отрицательное ( прокрутка влево ) значения
: type inScrollClickCountInt : int , обязательный
: param inXInt : Целевая позиция указателя мыши по оси X ( горизонтальная ось ) .
: type inXInt : int , опциональный
: param inYInt : Целевая позиция указателя мыши по оси Y ( вертикальная ось ) .
: type inYInt : int , опциональный
: param inWaitAfterSecFloat : Количество секунд , которые ожидать после выполнения операции . По умолчанию установлено в настройках модуля Mouse ( базовое значение 0.4 )
: type inWaitAfterSecFloat : float , опциональный
"""
if inWaitAfterSecFloat == None : inWaitAfterSecFloat = WAIT_AFTER_SEC_FLOAT
hscroll ( inScrollClickCountInt , x = inXInt , y = inYInt )
time . sleep ( inWaitAfterSecFloat )