window-enumerator 0.4.1

A Rust library for enumerating and filtering windows with multiple criteria including sorting and selection
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 std::path::PathBuf;

/// Represents a window's position and dimensions on the screen.
#[derive(Debug, Clone, Copy, Default)] // ← 添加 Default derive
pub struct WindowPosition {
    /// The x-coordinate of the window's top-left corner in screen coordinates.
    pub x: i32,
    /// The y-coordinate of the window's top-left corner in screen coordinates.
    pub y: i32,
    /// The width of the window in pixels.
    pub width: i32,
    /// The height of the window in pixels.
    pub height: i32,
}

// 删除手动实现的 Default for WindowPosition

/// Comprehensive information about a Windows window.
#[derive(Debug, Clone)]
pub struct WindowInfo {
    /// The window handle (HWND) as an isize.
    pub hwnd: isize,
    /// The process ID (PID) that owns the window.
    pub pid: u32,
    /// The window title text.
    pub title: String,
    /// The window class name.
    pub class_name: String,
    /// The name of the process executable.
    pub process_name: String,
    /// The full path to the process executable file.
    pub process_file: PathBuf,
    /// The 1-based index of this window in enumeration results.
    pub index: usize,
    /// The position and dimensions of the window.
    pub position: WindowPosition,
}

/// Criteria for filtering windows during enumeration.
#[derive(Debug, Clone, Default)]
pub struct FilterCriteria {
    /// Filter by exact process ID match.
    pub pid: Option<u32>,
    /// Filter by title containing the specified string (case-insensitive).
    pub title_contains: Option<String>,
    /// Filter by class name containing the specified string (case-insensitive).
    pub class_name_contains: Option<String>,
    /// Filter by process name containing the specified string (case-insensitive).
    pub process_name_contains: Option<String>,
    /// Filter by process file path containing the specified string (case-insensitive).
    pub process_file_contains: Option<String>,
}

#[cfg(feature = "selection")]
/// Selection criteria for choosing specific windows from enumeration results.
#[derive(Debug, Clone)]
pub enum Selection {
    /// Select all windows that match the filter criteria.
    All,
    /// Select windows by their 1-based indices.
    Indices(Vec<usize>),
}

#[cfg(feature = "sorting")]
/// Position-based sorting criteria for windows.
#[derive(Debug, Clone)]
pub enum PositionSort {
    /// Sort by X coordinate only.
    X(i8), // 1: ascending, -1: descending
    /// Sort by Y coordinate only.
    Y(i8), // 1: ascending, -1: descending
    /// Sort by X coordinate first, then Y coordinate.
    XY(i8, i8), // (x_order, y_order)
}

#[cfg(feature = "sorting")]
/// Criteria for sorting window enumeration results.
#[derive(Debug, Clone, Default)] // ← 添加 Default derive
pub struct SortCriteria {
    /// Sort by process ID (1: ascending, -1: descending, 0: no sorting).
    pub pid: i8,
    /// Sort by window title (1: ascending, -1: descending, 0: no sorting).
    pub title: i8,
    /// Sort by window position (None: no sorting, Some: position-based sorting).
    pub position: Option<PositionSort>,
}

// 删除手动实现的 Default for SortCriteria