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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

use std::marker::PhantomPinned;
use std::pin::Pin;
use std::sync::Arc;

use crate::co;
use crate::decl::*;
use crate::gui::privs::*;
use crate::prelude::*;

struct DlgMainObj {
	dlg_base: DlgBase,
	icon_id: Option<u16>,
	accel_tbl_id: Option<u16>,
	_pin: PhantomPinned,
}

/// A dialog-based main window.
///
/// Hierarchy: `BaseWnd` -> `RawBase` -> `DlgMain`.
#[derive(Clone)]
pub(in crate::gui) struct DlgMain(Pin<Arc<DlgMainObj>>);

impl DlgMain {
	#[must_use]
	pub(in crate::gui) fn new(
		dlg_id: u16,
		icon_id: Option<u16>,
		accel_tbl_id: Option<u16>,
	) -> Self {
		let new_self = Self(Arc::pin(DlgMainObj {
			dlg_base: DlgBase::new(dlg_id),
			icon_id,
			accel_tbl_id,
			_pin: PhantomPinned,
		}));
		new_self.default_message_handlers();
		new_self
	}

	fn default_message_handlers(&self) {
		let self2 = self.clone();
		self.0.dlg_base.base().on().wm_close(move || {
			self2.0.dlg_base.base().hwnd().DestroyWindow().ok(); // ignore errors
			Ok(())
		});

		self.0.dlg_base.base().on().wm_nc_destroy(|| {
			PostQuitMessage(0);
			Ok(())
		});
	}

	#[must_use]
	pub(in crate::gui) fn dlg_base(&self) -> &DlgBase {
		&self.0.dlg_base
	}

	pub(in crate::gui) fn run_main(
		&self,
		hinst: &HINSTANCE,
		cmd_show: Option<co::SW>,
	) -> AnyResult<i32> {
		self.0.dlg_base.create_dialog_param(hinst, None);
		if let Some(id) = self.0.icon_id {
			self.0.dlg_base.set_icon(hinst, id)?;
		}

		let haccel = self
			.0
			.accel_tbl_id
			.map(|id| hinst.LoadAccelerators(IdStr::Id(id))) // resources are automatically freed
			.transpose()?;

		self.0
			.dlg_base
			.base()
			.hwnd()
			.ShowWindow(cmd_show.unwrap_or(co::SW::SHOW));
		BaseWnd::run_main_loop(haccel.as_deref(), true) // blocks until window is closed
	}
}