windows-api-utils 0.2.0

Windows API utilities for coordinate conversion, bit operations, and message parameter handling with feature gating
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

//! Error types for Windows API utilities.
//!
//! This module provides error types that are always available,
//! regardless of which features are enabled.

#[cfg(feature = "std")]
use thiserror::Error;

/// Errors that can occur in Windows API utilities.
#[cfg_attr(feature = "std", derive(Error))]
#[cfg_attr(not(feature = "std"), derive(Debug, Clone, PartialEq))]
#[derive(Debug, Clone, PartialEq)]
pub enum WindowsUtilsError {
    /// Invalid coordinates provided.
    #[cfg_attr(feature = "std", error("Invalid coordinates: ({x}, {y})"))]
    InvalidCoordinates {
        /// X coordinate
        x: i32,
        /// Y coordinate
        y: i32,
    },

    /// Point is outside the window bounds.
    #[cfg_attr(feature = "std", error("Point ({x}, {y}) is outside window bounds"))]
    OutOfBounds {
        /// X coordinate
        x: i32,
        /// Y coordinate
        y: i32,
    },

    /// Invalid window handle.
    #[cfg_attr(feature = "std", error("Invalid window handle: {handle}"))]
    InvalidWindowHandle {
        /// Window handle
        handle: isize,
    },

    /// Invalid message parameter.
    #[cfg_attr(feature = "std", error("Invalid message parameter: {parameter}"))]
    InvalidMessageParameter {
        /// Parameter description
        parameter: &'static str, // Changed from String to &'static str for no_std
    },

    /// Unsupported message type.
    #[cfg_attr(feature = "std", error("Unsupported message type: 0x{message:x}"))]
    UnsupportedMessage {
        /// Message ID
        message: u32,
    },

    /// Feature not enabled.
    #[cfg_attr(feature = "std", error("Required feature not enabled: {feature}"))]
    FeatureNotEnabled {
        /// Required feature name
        feature: &'static str,
    },
}

/// Result type for Windows API utilities.
pub type WindowsUtilsResult<T> = Result<T, WindowsUtilsError>;