winsafe 0.0.27

Windows API and GUI in safe, idiomatic Rust.
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

#![allow(non_camel_case_types, non_snake_case)]

use crate::co;
use crate::decl::*;
use crate::kernel::privs::*;
use crate::shell::ffi;

impl HWND {
	/// [`DragAcceptFiles`](https://learn.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-dragacceptfiles)
	/// function.
	pub fn DragAcceptFiles(&self, accept: bool) {
		unsafe {
			ffi::DragAcceptFiles(self.ptr(), accept as _);
		}
	}

	/// [`ShellAbout`](https://learn.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shellaboutw)
	/// function.
	pub fn ShellAbout(
		&self,
		title_bar: &str,
		first_line: Option<&str>,
		other_stuff: Option<&str>,
		hicon: Option<&HICON>,
	) -> SysResult<()> {
		BoolRet(unsafe {
			ffi::ShellAboutW(
				self.ptr(),
				WString::from_str(&match first_line {
					Some(line) => format!("{}#{}", title_bar, line),
					None => title_bar.to_owned(),
				})
				.as_ptr(),
				WString::from_opt_str(other_stuff).as_ptr(),
				hicon.map_or(std::ptr::null_mut(), |h| h.ptr()),
			)
		})
		.to_sysresult()
	}

	/// [`ShellExecute`](https://learn.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shellexecutew)
	/// function.
	pub fn ShellExecute(
		&self,
		operation: &str,
		file: &str,
		parameters: Option<&str>,
		directory: Option<&str>,
		show_cmd: co::SW,
	) -> SysResult<()> {
		let ret = unsafe {
			ffi::ShellExecuteW(
				self.ptr(),
				WString::from_str(operation).as_ptr(),
				WString::from_str(file).as_ptr(),
				parameters.map_or(std::ptr::null(), |lp| WString::from_str(lp).as_ptr()),
				directory.map_or(std::ptr::null(), |lp| WString::from_str(lp).as_ptr()),
				show_cmd.raw(),
			)
		};

		if ret as usize > 32 { Ok(()) } else { Err(GetLastError()) }
	}
}