hwnd 0.0.0-2024-01-05

Well documented, safe-leaning, sound, low-level API bindings to `HWND`-adjacent APIs
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

use winapi::um::errhandlingapi::GetLastError;
use winresult::*;
use std::fmt::{self, Debug, Display, Formatter};



/// An error generated by the `hwnd` crate
#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Error(pub(crate) ErrorHResultOrCode);

impl Error {
    pub(crate) fn new_gle() -> Self {
        Self(ErrorHResultOrCode::from(unsafe { GetLastError() }))
    }

    pub(crate) fn new_gle_nz() -> Result<(), Self> {
        let e = Self::new_gle();
        if e == ERROR::SUCCESS { return Ok(()) }
        Err(e)
    }

    pub const fn to_u32(&self) -> u32 { self.0.to_u32() }
    pub       fn code(&self) -> Option<ErrorCode> { self.0.to_code().map(|c| ErrorCode::from(c)) }
}

impl Debug   for Error { fn fmt(&self, fmt: &mut Formatter) -> fmt::Result { write!(fmt, "hwnd::Error({:?})",           self.0) }}
impl Display for Error { fn fmt(&self, fmt: &mut Formatter) -> fmt::Result { write!(fmt, "error handling HWNDs: {:?}",  self.0) }}

impl PartialEq<ErrorCode            > for Error { fn eq(&self, other: &ErrorCode            ) -> bool { self.to_u32() == other.to_u32() } }
impl PartialEq<HResultError         > for Error { fn eq(&self, other: &HResultError         ) -> bool { self.to_u32() == other.to_u32() } }
impl PartialEq<ErrorHResultOrCode   > for Error { fn eq(&self, other: &ErrorHResultOrCode   ) -> bool { self.to_u32() == other.to_u32() } }

impl PartialEq<Error> for ErrorCode             { fn eq(&self, other: &Error) -> bool { self.to_u32() == other.to_u32() } }
impl PartialEq<Error> for HResultError          { fn eq(&self, other: &Error) -> bool { self.to_u32() == other.to_u32() } }
impl PartialEq<Error> for ErrorHResultOrCode    { fn eq(&self, other: &Error) -> bool { self.to_u32() == other.to_u32() } }