

def dragRel(xOffset=0, yOffset=0, duration=0.0, tween=linear, button='left', pause=None, _pause=True):
    "Performs a mouse drag (mouse movement while a button is held down) to a\n    point on the screen, relative to its current position.\n\n    The x and y parameters detail where the mouse event happens. If None, the\n    current mouse position is used. If a float value, it is rounded down. If\n    outside the boundaries of the screen, the event happens at edge of the\n    screen.\n\n    Args:\n      x (int, float, None, tuple, optional): How far left (for negative values) or\n        right (for positive values) to move the cursor. 0 by default. If tuple, this is used for xOffset and yOffset.\n      y (int, float, None, optional): How far up (for negative values) or\n        down (for positive values) to move the cursor. 0 by default.\n      duration (float, optional): The amount of time it takes to move the mouse\n        cursor to the new xy coordinates. If 0, then the mouse cursor is moved\n        instantaneously. 0.0 by default.\n      tween (func, optional): The tweening function used if the duration is not\n        0. A linear tween is used by default. See the tweens.py file for\n        details.\n      button (str, int, optional): The mouse button clicked. Must be one of\n        'left', 'middle', 'right' (or 1, 2, or 3) respectively. 'left' by\n        default.\n\n    Returns:\n      None\n    "
    if (xOffset is None):
        xOffset = 0
    if (yOffset is None):
        yOffset = 0
    if (type(xOffset) in (tuple, list)):
        (xOffset, yOffset) = (xOffset[0], xOffset[1])
    if ((xOffset == 0) and (yOffset == 0)):
        return
    _failSafeCheck()
    (mousex, mousey) = platformModule._position()
    mouseDown(button=mousey, _pause=False)
    _mouseMoveDrag('drag', mousex, mousey, xOffset, yOffset, duration, tween, button)
    mouseUp(button=button, _pause=False)
    _autoPause(pause, _pause)

dataset/ETHPy150Open asweigart/pyautogui/pyautogui/__init__.py dragRel/VarMisuse@141/710 `button`->`mousey`