winsafe 0.0.28

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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

#![allow(non_camel_case_types, non_snake_case)]

use crate::co;
use crate::decl::*;
use crate::dwm::ffi;
use crate::kernel::privs::*;
use crate::ole::privs::*;

impl HWND {
	/// [`DwmExtendFrameIntoClientArea`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmextendframeintoclientarea)
	/// function.
	pub fn DwmExtendFrameIntoClientArea(&self, margins_inset: &MARGINS) -> HrResult<()> {
		HrRet(unsafe { ffi::DwmExtendFrameIntoClientArea(self.ptr(), pcvoid(margins_inset)) })
			.to_hrresult()
	}

	/// [`DwmGetWindowAttribute`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmgetwindowattribute)
	/// function.
	pub fn DwmGetWindowAttribute(&self, attribute: co::DWMWA) -> HrResult<DwmAttr> {
		let mut buf_u32 = 0u32;
		let mut buf_rc = RECT::new();
		let (ptr, sz) = DwmAttr::ptr_sz_of_flag(attribute, &mut buf_u32, &mut buf_rc);

		HrRet(unsafe { ffi::DwmGetWindowAttribute(self.ptr(), attribute.raw(), ptr, sz) })
			.to_hrresult()
			.map(|_| DwmAttr::from_raw(attribute, buf_u32, buf_rc))
	}

	/// [`DwmInvalidateIconicBitmaps`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwminvalidateiconicbitmaps)
	/// function.
	pub fn DwmInvalidateIconicBitmaps(&self) -> HrResult<()> {
		HrRet(unsafe { ffi::DwmInvalidateIconicBitmaps(self.ptr()) }).to_hrresult()
	}

	/// [`DwmModifyPreviousDxFrameDuration`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmmodifypreviousdxframeduration)
	/// function.
	pub fn DwmModifyPreviousDxFrameDuration(
		&self,
		num_refreshes: i32,
		relative_to_current: bool,
	) -> HrResult<()> {
		HrRet(unsafe {
			ffi::DwmModifyPreviousDxFrameDuration(
				self.ptr(),
				num_refreshes,
				relative_to_current as _,
			)
		})
		.to_hrresult()
	}

	/// [`DwmSetIconicLivePreviewBitmap`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmseticoniclivepreviewbitmap)
	/// function.
	pub fn DwmSetIconicLivePreviewBitmap(
		&self,
		hbmp: HBITMAP,
		pt_client: Option<POINT>,
		sit_flags: Option<co::DWM_SIT>,
	) -> HrResult<()> {
		HrRet(unsafe {
			ffi::DwmSetIconicLivePreviewBitmap(
				self.ptr(),
				hbmp.ptr(),
				pcvoid_or_null(pt_client.as_ref()),
				sit_flags.unwrap_or_default().raw(),
			)
		})
		.to_hrresult()
	}

	/// [`DwmSetIconicThumbnail`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmseticonicthumbnail)
	/// function.
	pub fn DwmSetIconicThumbnail(
		&self,
		hbmp: HBITMAP,
		sit_flags: Option<co::DWM_SIT>,
	) -> HrResult<()> {
		HrRet(unsafe {
			ffi::DwmSetIconicThumbnail(self.ptr(), hbmp.ptr(), sit_flags.unwrap_or_default().raw())
		})
		.to_hrresult()
	}

	/// [`DwmSetWindowAttribute`](https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/nf-dwmapi-dwmsetwindowattribute)
	/// function.
	pub fn DwmSetWindowAttribute(&self, attribute: DwmAttr) -> HrResult<()> {
		let mut buf_u32 = 0u32;
		let mut buf_rc = RECT::new();

		HrRet(unsafe {
			ffi::DwmSetWindowAttribute(
				self.ptr(),
				attribute.flag().raw(),
				attribute.ptr(&mut buf_u32, &mut buf_rc),
				attribute.sz(),
			)
		})
		.to_hrresult()
	}
}