autogui 0.3.1

GUI Automation toolbox for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use core_graphics::geometry::CGPoint;
use core_graphics::event::{CGEvent, CGEventType, EventField, CGMouseButton};

use action::MouseButton;
use super::{post_event, get_default_source};

fn post_mouse_event(et: CGEventType, p: CGPoint, b: Option<CGMouseButton>) {
    // https://developer.apple.com/documentation/coregraphics/cgevent/1454356-init
    post_event(CGEvent::new_mouse_event(
        get_default_source(),
        et,
        p,
        b.unwrap_or(CGMouseButton::Left) // Usually ignored (see docs)
    ).unwrap());
}

pub(super) fn mouse_down(button: MouseButton, p: CGPoint) {
    let b = match button {
        MouseButton::Left  => CGEventType::LeftMouseDown,
        MouseButton::Right => CGEventType::RightMouseDown,
    };

    post_mouse_event(b, p, None);
}

pub(super) fn mouse_up(button: MouseButton, p: CGPoint) {
    let b = match button {
        MouseButton::Left  => CGEventType::LeftMouseUp,
        MouseButton::Right => CGEventType::RightMouseUp,
    };

    post_mouse_event(b, p, None);
}

/// https://stackoverflow.com/a/1483666/2867076
pub(super) fn mouse_n_click(button: MouseButton, p: CGPoint, n: u8) {
    assert!(1 <= n && n <= 3);

    if n == 1 { // singleclick optimization
        mouse_down(button, p);
        mouse_up(button, p);
        return;
    }

    let b_down = match button {
        MouseButton::Left  => CGEventType::LeftMouseDown,
        MouseButton::Right => CGEventType::RightMouseDown,
    };

    let b_up = match button {
        MouseButton::Left  => CGEventType::LeftMouseUp,
        MouseButton::Right => CGEventType::RightMouseUp,
    };

    let event = CGEvent::new_mouse_event(
        get_default_source(),
        b_down,
        p,
        CGMouseButton::Left // Ignored here (see docs)
    ).unwrap();

    event.set_integer_value_field(EventField::MOUSE_EVENT_CLICK_STATE, n as i64);
    post_event(event.clone());
    event.set_type(b_up);
    post_event(event.clone());

    mouse_up(button, p);

    for _ in 0..(n-1) {
        event.set_type(b_down);
        post_event(event.clone());
        event.set_type(b_up);
        post_event(event.clone());
    }
}

pub(super) fn mouse_drag(button: MouseButton, p: CGPoint) {
    let b = match button {
        MouseButton::Left  => CGEventType::LeftMouseDragged,
        MouseButton::Right => CGEventType::RightMouseDragged,
    };

    post_mouse_event(b, p, None);
}

pub(super) fn mouse_move(p: CGPoint) {
    post_mouse_event(CGEventType::MouseMoved, p, None);
}