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

use crate::*;
use winapi::um::winuser::*;



/// \[[learn.microsoft.com](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-replymessage)\]
/// ReplyMessage
///
/// Replies to a message sent from another thread by the [send_message](send_message_w) function.
///
/// ### Example
/// ```rust
/// # use hwnd::*;
/// // Not in a wndproc, so this will always fail:
/// reply_message(0).unwrap_err();
// TODO: non-failing example
/// ```
pub fn reply_message(lresult: LRESULT) -> Result<(), ReplyMessageError> {
    fn_context!(reply_message => ReplyMessage);
    match unsafe { ReplyMessage(lresult) } {
        0       => Err(ReplyMessageError(())),
        1 | _   => Ok(()),
    }
}

/// \[[learn.microsoft.com](https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-replymessage)\]
/// [reply_message] failed (wasn't handling a message sent by [send_message](send_message_w) or similar.)
#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)] pub struct ReplyMessageError(());

impl std::fmt::Display for ReplyMessageError {
    fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(fmt, "ReplyMessage failed: wasn't handling a message sent by SendMessage et al.")
    }
}