wintrack 1.0.1

Library for monitoring window related events on Windows.
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

# Wintrack

A library for monitoring window related events on Windows.

> View API reference on [docs.rs](https://docs.rs/wintrack), and the crate page on [crates.io](https://crates.io/crates/wintrack).

## Features

- Listen for various window related events
    -  Foreground (active) window changed
    -  Window title or name changed
    -  Window became visible (unminimized / moved onscreen)
    -  Window became hidden (minimized / moved offscreen)
    -  New window was created
    -  Window was destroyed or closed
    -  Window was moved or resized
-  Define callback that will be called when event is received
-  Callback includes snapshot of window's state at time of event
-  snapshot has title, rect, executable, etc.
- Safe wrapper over Win32 API & robust error handling

## Demo

Using a channel to receive messages:
```rust
use std::sync::mpsc;
use wintrack::WindowEventKind;

wintrack::try_hook().expect("hook should not be set yet");

let (tx, rx) = mpsc::channel();

wintrack::set_callback(Box::new(move |event| {
    let snapshot_exe = event.snapshot.executable.file_name();
    let is_firefox = snapshot_exe == Some(OsStr::new("firefox.exe"));
    // only monitor name change events from Firefox
    // (this checks when the tab changes)
    if is_firefox && event.kind == WindowEventKind::WindowNameChanged {
        // send the event to the main thread
        let res = tx.send(event.snapshot);
        if let Err(err) = res {
            // ...
        }
    }
}));

while let Ok(browser_snapshot) = rx.recv() {
    println!("Your active Firefox tab changed to {}.", browser_snapshot.title);
}
```